创建IO请求
目前框架只对5中IRP请求进行WDFREQUEST对象封装,但实际上WDFREQUEST对象可以封装任何一种IRP请求,WDF驱动程序除了使用框架通过时间回调传递的WDFREQUEST对象外,还可以自己新建任何类型的WDFREQUEST对象。
参数IoTarget指明发送到的IO目标,WDFIOTARGET对象是对DEVICE_OBJECT对象的封装,最终使用的也恰恰是这个设备对象指针;参数Request传入一个前面创建的WDFREQUEST对象句柄,当函数调用成功后,这个对象的内部将焕然一新。
两种方法:
1、创建空对象,然后调用格式化函数,将对象格式化为指定类型的命令。有4种(5个)函数可用,这种方法只能创建4种WDFREQUEST对象。
2、直接通过一个指定的IRP创建,使用此方法可以创建任何类型的WDFREQUEST对象,根据IRP类型而定。
调用
WdfRequestCreate
创建一个空对象
NTSTATUS WdfRequestCreate(IN OPTIONAL PWDF_OBJECT_ATTRIBUTES RequestAttributes, IN OPTIONAL WDFIOTARGET IoTarget, OUT WDFREQUEST* Request);参数RequestAttribtues用来配置将被创建的框架对象,这个类型的参数并不是仅针对于WDFREQUEST对象,所有继承自WDFOBJECT的框架对象都使用WDF_OBJECT_ATTRIBUTES结构体进行对象配置。
IoTarget是一个可选参数,仅用来做验证,不会被保存,如果不为NULL,则WdfRequestCreate函数将验证新建的对象,是否可以被发送到此IO目标对象,如果不能,则创建失败,返回STATUS_REQUEST_NOT_ACCEPTED,表面系统资源不足。
创建成功,就会返回一个WDFREQUEST对象句柄,而在使用之前,要对它进行格式化,有如下4种(5个)函数
WdfIoTargetFormatRequest第一个函数将WDFREQUEST对象格式化为IRP_MJ_DEVICE_CONTROL命令;第二第三个函数将WDFREQUEST对象格式化为IRP_MJ_INTERNAL_DEVICE_CONTROL命令,这两个函数使用了不同的参数;第四个函数将WDFREQUEST对象格式化为IRP_MJ_READ命令;第五个函数将WDFREQUEST对象格式化为IRP_MJ_WRITE命令。ForIoctl WdfIoTargetFormatRequest ForInternalIoctl WdfIoTargetFormatRequest ForInternalIoctlothers WdfIoTargetFormatRequest ForRead WdfIoTargetFormatRequest ForWrite
NTSTATUS WdfIoTargetFormatRequestForRead(IN WDFIOTARGET IoTarget, IN OUT WDFREQUEST Request, IN OPTIONAL WDFMEMORY OutputBuffer, IN OPTIONAL PWDFMEMORY_OFFSET OutputBufferOffset, IN OPTIONAL PLONGLONG DeviceOffset);
第二种创建WDFREQUEST对象的方法是调用WdfRequestCreateFromIrp,选择直接从一个已有的IRP结构体进行封装
NTSTATUS WdfRequestCreateFromIrp(IN OPTIONAL PWDF_OBJECT_ATTRIBUTES RequestAttributes, IN PIRP Irp, IN BOOLEAN RequestFreesIrp, OUT WDFREQUEST* Request);!! 参数RequestFreesIrp为TRUE时,则WDFREQUEST对象被删除时,将负责调用IoFreeIrp释放irp,否则用户必须手动释放他
WDF驱动创建的WDFREQUEST对象,必须最后调用WdfObjectDelete方法进行删除。但如果对象是由框架通过参数传递给WDF驱动的,则不可调用WdfObjectDelete方法删除,这个权利应当让给框架在其内部进行
最后提一提发送请求。调用框架接口函数WdfRequestSend将一个请求发送到指定的IO目标对象
BOOLEAN WdfRequestSend(IN WDFREQUEST Request, IN WDFIOTARGET Target, IN OPTIONAL PWDF_REQUEST_SEND_OPTIONS RequestOptions);重点是 RequestOptions
typedef struct _WDF_REQUEST_SEND_OPTIONS{ IN ULONG Size; IN ULONG Flags; IN LONGLONG Timeout; }WDF_REQUEST_SEND_OPTIONS,*PWDF_REQUEST_SEND_OPTIONS;Flags是标志值,其实重要的两个是:
WDF_REQUEST_SEND_OPTION_SYNCHRONOUS:同步标志。设置同步标志后,直到所有发送的请求被完成,WdfRequestSend函数才会返回。请求被完成前,调用者一直处于阻塞状态;如果不设置此标志,则采用相反的异步方式发送请求,WdfRequestSend被调用后立即返回,而请求完成时,指定的完成函数将被调用。
WDF_REQUEST_SEND_OPTION_TIMEOUT:超时标志。设置超时标志后,框架把WDF_REQUEST_SEND_OPTIONS结构体中的Timeout值作为超时值计算超时。
参考
io请求 谷歌
io请求 数据结构 谷歌
参考
io请求 谷歌
io请求 数据结构 谷歌