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 结构的 标志 成员中设置 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)
WUDFx02000.lib;WUDFx02000.dll
IRQL PASSIVE_LEVEL

另请参阅

WdfRequestGetUserModeDriverInitiatedIo