[警告: UMDF 2 是最新版本的 UMDF,取代了 UMDF 1。 所有新的 UMDF 驱动程序都应使用 UMDF 2 编写。 没有将新功能添加到 UMDF 1,并且对较新版本的 Windows 10 上的 UMDF 1 的支持有限。 通用 Windows 驱动程序必须使用 UMDF 2。 有关详细信息,请参阅 UMDF入门 。]
ConfigureRequestDispatching 方法配置给定类型的 I/O 请求的队列。
语法
HRESULT ConfigureRequestDispatching(
[in] WDF_REQUEST_TYPE RequestType,
[in] BOOL Forward
);
参数
[in] RequestType
一个 WDF_REQUEST_TYPE类型化值,用于标识要排队的请求类型。 唯一的有效值是 WdfRequestCreate、WdfRequestRead、WdfRequestWrite和 WdfRequestDeviceIoControl。
[in] Forward
一个 BOOL 值,该值指定指定类型的请求是否排队。 TRUE 指示启用队列请求;FALSE 指示禁用队列请求。
返回值
ConfigureRequestDispatching 如果作成功,则返回S_OK。 否则,此方法返回在 Winerror.h 中定义的错误代码之一。
言论
驱动程序可以多次调用 ConfigureRequestDispatching 方法,以配置如何将每个请求类型调度到 I/O 队列。
例子
下面的代码示例演示如何为 IOCTL 请求配置转发。
//
// Configure forwarding for IOCTL requests
//
HRESULT hr = m_FxQueue->ConfigureRequestDispatching(
WdfRequestDeviceIoControl,
true
);
要求
| 要求 | 价值 |
|---|---|
| 终止支持 | 在 UMDF 2.0 及更高版本中不可用。 |
| 目标平台 | 桌面 |
| 最低 UMDF 版本 | 1.5 |
| 标头 | wudfddi.h (包括 Wudfddi.h) |
| DLL | WUDFx.dll |