共用方式為

SerCxRetrieveTransmitBuffer 函式 （sercx.h）

  • 發行項

SerCxRetrieveTransmitBuffer 方法會取得輸出緩衝區，其中包含準備傳送至序列埠的數據。

語法

NTSTATUS SerCxRetrieveTransmitBuffer(
  [in]      WDFDEVICE                Device,
  [in]      ULONG                    Length,
  [in, out] PSERCX_BUFFER_DESCRIPTOR BufferDescriptor
);

參數

[in] Device

代表序列控制器之架構裝置物件的WDFDEVICE句柄。

[in] Length

要求的緩衝區長度，以位元組為單位。 如果 SerCxRetrieveTransmitBuffer 呼叫成功，呼叫端會收到輸出緩衝區，其中包含最多 長度 位元組的可用數據。 （緩衝區中的可用數據可能小於 Length bytes。SerCxRetrieveTransmitBuffer 會將可用資料的實際位元組數目寫入 BufferDescriptor 參數所指向之結構 Length 成員。

[in, out] BufferDescriptor

呼叫端配置的 SERCX_BUFFER_DESCRIPTOR 結構的指標。 此結構描述用於傳輸作業的數據緩衝區。 呼叫端先前呼叫 SERCX_BUFFER_DESCRIPTOR_INIT 函式，以初始化這個結構。 SerCxRetrieveTransmitBuffer 寫入 緩衝區，並 長度 這個結構的成員。

傳回值

SerCxRetrieveTransmitBuffer 如果成功，就會傳回STATUS_SUCCESS。 可能的錯誤傳回值包括下列狀態代碼。

傳回碼 描述
STATUS_INVALID_DEVICE_REQUEST
 在錯誤的 IRQL 呼叫方法;或 WDFDEVICE 句柄無效;或 Device 或 BufferDescriptor 為 NULL;或驅動程式已經有傳輸緩衝區。
STATUS_INFO_LENGTH_MISMATCH
 為 SERCX_BUFFER_DESCRIPTOR 結構指定了錯誤的大小。
STATUS_INSUFFICIENT_RESOURCES
 無法配置系統資源（通常是記憶體）。

言論

序列控制器驅動程式會呼叫這個方法，以取得緩衝區，其中包含目前傳輸（寫入）作業的輸出數據。

要求

要求 價值
最低支援的用戶端 從 Windows 8 開始提供。
目標平臺 普遍
標頭 sercx.h
IRQL <= DISPATCH_LEVEL

另請參閱

SERCX_BUFFER_DESCRIPTOR

SERCX_BUFFER_DESCRIPTOR_INIT