IQueueCallbackRead：：OnRead 方法（wudfddi.h）

發行項
02/07/2025

[警告： UMDF 2 是最新版本的 UMDF，並取代 UMDF 1。所有新的UMDF驅動程式都應該使用UMDF 2撰寫。未將新功能新增至 UMDF 1，而且較新版本的 Windows 10 上對 UMDF 1 的支援有限。通用 Windows 驅動程式必須使用 UMDF 2。如需詳細資訊，請參閱開始使用 UMDF。]

當應用程式透過 Microsoft Win32 ReadFile 或 ReadFileEx 函式從裝置讀取資訊時，會呼叫 OnRead 方法來處理讀取要求。

語法

void OnRead(
  [in] IWDFIoQueue   *pWdfQueue,
  [in] IWDFIoRequest *pWdfRequest,
  [in] SIZE_T        NumOfBytesToRead
);

參數

[in] pWdfQueue

要求從中抵達之 I/O 佇列物件的 IWDFIoQueue 介面指標。

[in] pWdfRequest

代表架構要求物件的 IWDFIoRequest 介面指標。

[in] NumOfBytesToRead

要求讀取緩衝區的大小，以位元組為單位。

傳回值

沒有

言論

驅動程式會在驅動程式呼叫 IWDFDevice：：CreateIoQueue 方法來建立 I/O 佇列或設定預設 I/O 佇列時，註冊 IQueueCallbackRead 介面。

驅動程式可以針對所有 I/O 佇列實作單一 OnRead 方法，或為每個 I/O 佇列實作個別的 OnRead 方法。

OnRead 方法會從佇列接收每個讀取要求類型。（讀取要求類型是由要求 WDF_REQUEST_TYPE 列舉類型的 WdfRequestRead 值所識別。OnRead 方法必須處理每個收到的讀取要求。如需 UMDF 驅動程式如何處理 I/O 要求的詳細資訊，請參閱處理 I/O 要求。

驅動程式可以呼叫 IWDFIoRequest：：GetReadParameters 和 IWDFIoRequest：：GetOutputMemory 方法來擷取要求和讀取緩衝區的相關信息。