共用方式為

SerCxRetrieveReceiveMdl 函式 （sercx.h）

  • 發行項

SerCxRetrieveReceiveMdl 方法會擷取描述用來接收下一個輸入數據區塊之緩衝區的 MDL。

語法

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

參數

[in] Device

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

[out] Mdl

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

傳回值

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

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

言論

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

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

要求

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

另請參閱

SerCxProgressReceive