共用方式為


IQueueCallbackWrite::OnWrite 方法 (wudfddi.h)

[警告: UMDF 2 是最新版的 UMDF,並取代 UMDF 1。 所有新的 UMDF 驅動程式都應該使用 UMDF 2 來撰寫。 未將新功能新增至 UMDF 1,且較新版本的 #DAE65E4DBE799488CB587E4BFFE28019A 上不支援 UMDF 1。 通用 Windows 驅動程式必須使用 UMDF 2。 如需詳細資訊,請參閱使用 UMDF 使用者入門。]

當應用程式透過 Microsoft Win32 WriteFileWriteFileEx 函式將資訊寫入裝置時,會呼叫 OnWrite 方法來處理寫入要求。

語法

void OnWrite(
  [in] IWDFIoQueue   *pWdfQueue,
  [in] IWDFIoRequest *pWdfRequest,
  [in] SIZE_T        NumOfBytesToWrite
);

參數

[in] pWdfQueue

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

[in] pWdfRequest

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

[in] NumOfBytesToWrite

要求寫入緩衝區的大小,以位元組為單位。

傳回值

備註

當驅動程式呼叫 IWDFDevice::CreateIoQueue 方法以建立 I/O 佇列或設定預設 I/O 佇列時,驅動程式會註冊 IQueueCallbackWrite 介面。

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

OnWrite 方法會從佇列接收每個寫入要求類型。 (寫入要求類型是由 request.) OnWrite 方法必須處理每個收到的寫入要求之WDF_REQUEST_TYPE列舉類型的 WdfRequestWrite 值來識別。 如需 UMDF 驅動程式如何處理 I/O 要求的詳細資訊,請參閱 處理 I/O 要求

驅動程式可以呼叫 IWDFIoRequest::GetWriteParametersIWDFIoRequest::GetInputMemory 方法,以擷取要求和寫入緩衝區的相關信息。

規格需求

需求
目標平台 Windows
標頭 wudfddi.h (包括 Wudfddi.h)

另請參閱

IQueueCallbackWrite

IWDFDevice::CreateIoQueue

IWDFIoQueue

IWDFIoRequest

WDF_REQUEST_TYPE