WDF - WdfRequestComplete与IO 方式的关联

WDF 提供了两个方法来 complete io request(实际上 有三个)：

1. WdfRequestComplete;

2.WdfRequestCompleteWithInformation(,,)

IO MEthod 有三种方式：

METHOD_BUFFERED；

METHOD_DIRECT;

METHOD_NEITHER;

这里只讨论前面两种，METHOD_BUFFERED；METHOD_DIRECT; 情况下如何使用正确的IO complete function。

 如果使用自定义的IOCTL code， 如下：

#define IOCTL_UIHGWB_MALLOC_MEMO    \     CTL_CODE(FILE_DEVICE_UIHGWB, 0x804,\     METHOD_BUFFERED, FILE_READ_DATA|FILE_WRITE_DATA)

使用此IOCTL 的接口是windows的API DeviceIOControl； 其原型：

BOOL WINAPI DeviceIoControl( _In_ HANDLE hDevice, _In_ DWORD dwIoControlCode, _In_opt_ LPVOID lpInBuffer, _In_ DWORD nInBufferSize, _Out_opt_ LPVOID lpOutBuffer, _In_ DWORD nOutBufferSize, _Out_opt_ LPDWORD lpBytesReturned, _Inout_opt_ LPOVERLAPPED lpOverlapped);

前面说的三种IO Method， 其实只是针对Outbuff 来讲的， 使用Outbuffer一般是需要读取数据，此参数也可是NULL；

如果User使用DeviceIOcontrol的时候希望device 往outbuffer里写入数据，也就是user希望通过outbuffer 获取一些数据，

那么在WDF的驱动设计时候， VOID UIHGwb_EvtIoDeviceControl(IN WDFQUEUE  Queue,     IN WDFREQUEST  Request,     IN size_t  OutputBufferLength,     IN size_t  InputBufferLength,     IN ULONG  IoControlCode )；

函数需要注意request的 返回方式；

如果IOCTL code定义的是METHOD_BUFFERED， 那么需要使用WDFRequestCompleteWithInformation()接口，buffer的内容才会更新到User 的outbuffer； 使用WDFRequestComplete()接口返回的话， outbuffer的内容并不会更新；关于Method_buffered的工作原理，读者可以参考MSDN手册； 但是,不管哪个接口，如果返回的status不是  STATUS_SUCCESS，比如WdfRequestComplete(Request, STATUS_STATUS_INVALID_PARAMETER);或者WdfRequestCompleteWithInformation(Request, STATUS_STATUS_INVALID_PARAMETER, sizeof(ULONG64)); 那么outbuffer 都不会更新；！！ 如果IOCTL dode的定义的是METHOD_INDIRECT或者METHOD_OUTDIRECT，那么驱动只要更新了outbuffer的值，就是直接操作了user space的 outbuffer。参考MSDN资料；

所以， 为了保险起见， 直接使用DIRECT的方式，比较方便。