WdfRequestSetUserModeDriverInitiatedIo 函数 (wdfrequest.h)

[仅适用于 UMDF]

WdfRequestSetUserModeDriverInitiatedIo 方法向位于同一设备堆栈中的 UMDF 驱动程序下方的内核模式驱动程序指示应将特定请求视为来自 UMDF 驱动程序。

语法

void WdfRequestSetUserModeDriverInitiatedIo(
  [in] WDFREQUEST Request,
  [in] BOOLEAN    IsUserModeDriverInitiated
);

参数

[in] Request

框架请求对象的句柄。

[in] IsUserModeDriverInitiated

如果 为 TRUE,则指示请求应被视为由 UMDF 驱动程序启动的布尔值。 如果 为 FALSE,则此参数指示应将请求视为来自应用程序。

返回值

备注

如果 UMDF 驱动程序调用此方法且 IsUserModeDriverInitiated 参数设置为 TRUE,框架会在将请求转发到内核模式驱动程序之前,在 WDM IRP 结构的 Flags 成员中设置IRP_UM_DRIVER_INITIATED_IO标志。

驻留在同一设备堆栈中的 UMDF 驱动程序下方的内核模式驱动程序可以为此标志检查,以确定请求是否应被视为由 UMDF 驱动程序启动。

此标志不适用于可能通过文件句柄 I/O 目标或 Win32 I/O 目标从 UMDF 驱动程序接收请求的内核模式驱动程序。

如果驱动程序已验证请求,UMDF 驱动程序可能会将来自应用程序的请求的 IsUserModeDriverInitiated 参数设置为 TRUE

自行创建的驱动程序的请求已标记为源自 UMDF 驱动程序。

要求

要求
最低受支持的客户端 Windows 8.1
目标平台 通用
最低 UMDF 版本 2.0
标头 wdfrequest.h (包括 Wdf.h)
Library WUDFx02000.lib;WUDFx02000.dll
IRQL PASSIVE_LEVEL

另请参阅

WdfRequestGetUserModeDriverInitiatedIo