WdfRequestImpersonate 函数 (wdfrequest.h)
[仅适用于 UMDF]
WdfRequestImpersonate 方法注册驱动程序提供的事件回调函数,框架应调用该函数进行模拟。
语法
NTSTATUS WdfRequestImpersonate(
[in] WDFREQUEST Request,
[in] SECURITY_IMPERSONATION_LEVEL ImpersonationLevel,
[in] PFN_WDF_REQUEST_IMPERSONATE EvtRequestImpersonate,
[in, optional] PVOID Context
);
参数
[in] Request
表示正在完成的 I/O 请求的框架请求对象的句柄。
[in] ImpersonationLevel
一个SECURITY_IMPERSONATION_LEVEL类型的值,用于标识模拟的级别。
[in] EvtRequestImpersonate
指向驱动程序的 EvtRequestImpersonate 事件回调函数的指针。
[in, optional] Context
指向缓冲区的指针,该缓冲区包含与模拟调用相关的上下文信息。 框架在调用 EvtRequestImpersonate 事件回调函数时传递此上下文信息。 此参数是可选的,可以为 NULL
返回值
如果 WdfRequestImpersonate 方法未遇到任何错误,则返回STATUS_SUCCESS。
方法可能会返回其他 NTSTATUS 值。
注解
在 EvtRequestImpersonate 事件回调函数完成之前,WdfRequestImpersonate 方法不会返回。
有关详细信息,请参阅 处理 UMDF 驱动程序中的客户端模拟。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows 8.1 |
目标平台 | 通用 |
最低 UMDF 版本 | 2.0 |
标头 | wdfrequest.h (包括 Wdf.h) |
Library | WUDFx02000.lib |
DLL | WUDFx02000.dll |
IRQL | PASSIVE_LEVEL |