IQueueCallbackWrite::OnWrite 方法 (wudfddi.h)

[警告: UMDF 2 是最新版本的 UMDF,并取代 UMDF 1。 所有新的 UMDF 驱动程序都应使用 UMDF 2 编写。 未将新功能添加到 UMDF 1,并且对较新版本的 Windows 10 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