SERCX_BUFFER_DESCRIPTOR結構 (sercx.h)
SERCX_BUFFER_DESCRIPTOR 結構描述接收作業或傳輸作業的數據緩衝區。
語法
typedef struct SERCX_BUFFER_DESCRIPTOR {
USHORT Size;
PUCHAR Buffer;
ULONG Length;
} SERCX_BUFFER_DESCRIPTOR, *PSERCX_BUFFER_DESCRIPTOR;
成員
Size
這個 結構的大小,以位元組為單位。 SerCxRetrieveReceiveBuffer 和 SerCxRetrieveTransmitBuffer 方法會使用此成員來判斷呼叫端所使用的結構版本。 此結構的大小可能會在 Sercx.h 頭文件的未來版本中變更。
Buffer
緩衝區的虛擬記憶體位址。 緩衝區的記憶體未分頁。
Length
緩衝區中可用的位元元組數目。 此大小會決定接收或傳輸作業可傳輸的最大位元元組數目。
言論
序列控制器驅動程式會使用此結構中的資訊來判斷在接收作業期間從記憶體中讀取數據的位置,以及在傳輸作業期間在記憶體中寫入數據的位置。
在任何時候,都不能有一個以上的有效接收緩衝區和一個有效的傳輸緩衝區。 控制器驅動程式會呼叫 SerCxRetrieveReceiveBuffer 方法來取得接收緩衝區,並呼叫 SerCxRetrieveTransmitBuffer 方法來取得傳輸緩衝區。 這兩種方法會將緩衝區描述複製到呼叫端配置的 SERCX_BUFFER_DESCRIPTOR 結構中。 這些方法的後續呼叫會分別使接收緩衝區或傳輸緩衝區的先前發出描述元失效。 呼叫端不得存取緩衝區描述元所描述的緩衝區,該緩衝區描述項已不再有效。
連續呼叫 SerCxRetrieveReceiveBuffer 或 SerCxRetrieveTransmitBuffer 取得的緩衝區不保證是連續的。
控制器驅動程式必須先呼叫 SERCX_BUFFER_DESCRIPTOR_INIT 函式,以初始化 SERCX_BUFFER_DESCRIPTOR 結構,再將 結構傳遞至 SerCxRetrieveReceiveBuffer 或 SerCxRetrieveTransmitBuffer 方法。 初始化緩衝區描述元之後,就可以重複使用,而不需再次初始化。
要求
要求 | 價值 |
---|---|
最低支援的用戶端 | 從 Windows 8 開始支援。 |
標頭 | sercx.h |