共用方式為

SerCxRetrieveTransmitMdl 函式 （sercx.h）

  • 發行項

SerCxRetrieveTransmitMdl 方法會擷取描述要傳輸之下一個輸出數據區塊的 MDL。

語法

NTSTATUS SerCxRetrieveTransmitMdl(
  [in]  WDFDEVICE Device,
  [out] PMDL      *Mdl
);

參數

[in] Device

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

[out] Mdl

方法將指標寫入 MDL 的位置指標。

傳回值

如果呼叫成功，SerCxRetrieveTransmitMdl 會傳回STATUS_SUCCESS。 可能的傳回值包括下列錯誤碼。

傳回碼 描述
STATUS_INVALID_DEVICE_REQUEST
 如果發生下列其中一項，則會傳回此值：
  • 沒有要從中取得 MDL 的未完成傳輸要求。
  • 傳輸的目前位元組數目（如 SerCxProgressTransmit 方法所報告）不等於零。
  • 已經擷取緩衝區（而且尚未發生對 SerCxProgressTransmit 方法的對應呼叫）。
  • 已擷取 MDL （且尚未發生對 SerCxProgressTransmit 方法的對應呼叫）。

言論

序列控制器驅動程式會呼叫此函式，以取得用於目前傳輸（寫入）作業的 MDL。 MDL 描述驅動程式要從中取得要傳輸之數據的緩衝區內存。 驅動程式是這個 MDL 的獨佔擁有者，直到它呼叫 SerCxProgressTransmit 方法為止，之後 MDL 指標無效，而且驅動程式不得再嘗試存取 MDL 所描述的 MDL 或緩衝區內存。

如需 MDL 的詳細資訊，請參閱使用 MDL。

要求

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

另請參閱

SerCxProgressTransmit