透過集合功能整理內容 你可以依據偏好儲存及分類內容。

OTTcpCircularSendBuffer

#include <tcp_ext.h>

這個結構代表與 TCP 端點搭配使用的環狀傳送緩衝區。

摘要

您可以選擇使用循環傳送緩衝區。應用程式可以透過 TCP 端點,直接管理 otLinkedBuffers 來傳送資料。但是,部分應用程式認為使用環形傳送緩衝區可能更加方便;這類應用程式可以呼叫 otTcpCircularSendBufferWrite() 到「附加」環形傳送緩衝區,並透過 TCP 端點傳送出資料,並使用圓形傳送緩衝區來管理基礎 otLinkedBuffers。

otTcpCircularSendBuffer 是在 otTcpEndpoint 提供的 otLinkedBuffer 式 API 上實作。附加至 otTcpEndpoint 後,otTcpCircularSendBuffer 就會針對連線管理 otLinkedBuffers 作業。換句話說,在 otTcpEndpoint 上附加 otTcpCircularSendBuffer 後,應用程式不應在 otTcpEndpoint 上呼叫 otTcpSendByReference()otTcpSendByExtension()。應用程式應使用 otTcpCircularSendBufferWrite() 將資料新增至傳送緩衝區。

otTcpForwardProgress() 回呼是用來讓使用者在環狀傳送緩衝區中取得空間時瞭解的適當方法。在附加 otTcpCircularSendBufferotTcpEndpoint 上,應用程式「必須」安裝 otTcpForwardProgress() 回呼,並在回呼函式的開頭使用附加的 otTcpCircularSendBuffer 呼叫 otTcpCircularSendBufferHandleForwardProgress()。建議使用者「不」安裝 otTcpSendDone() 回呼,因為 otLinkedBuffers 的所有管理作業都會由環狀傳送緩衝區處理。

應用程式不應直接檢查這個結構的欄位,而應該透過這個檔案中提供的簽章的 TCP Circular Send Buffer API 函式來與其互動。

公開屬性

mCapacity
size_t
環形傳送緩衝區的長度。
mCapacityUsed
size_t
傳送緩衝區中儲存的位元組數。
mDataBuffer
uint8_t *
循環傳送緩衝區中的資料指標。
mFirstSendLinkIndex
uint8_t
mSendLinks[2]
mStartIndex
size_t
傳送緩衝區中第一個有效位元組的索引。

公開屬性

容量

size_t otTcpCircularSendBuffer::mCapacity

環形傳送緩衝區的長度。

已使用的容量

size_t otTcpCircularSendBuffer::mCapacityUsed

傳送緩衝區中儲存的位元組數。

mData 緩衝區

uint8_t * otTcpCircularSendBuffer::mDataBuffer

循環傳送緩衝區中的資料指標。

主要傳送連結索引

uint8_t otTcpCircularSendBuffer::mFirstSendLinkIndex
otLinkedBuffer otTcpCircularSendBuffer::mSendLinks[2]

mStart 索引

size_t otTcpCircularSendBuffer::mStartIndex

傳送緩衝區中第一個有效位元組的索引。

資源

OpenThread API 參考資料主題出自原始碼,可於 GitHub 取得。如需更多資訊,或想參閱我們的說明文件,請參閱資源