WdfRequestWdmGetIrp 函数 (wdfrequest.h)

[仅适用于 KMDF]

WdfRequestWdmGetIrp 方法返回与指定框架请求对象关联的 WDM IRP 结构。

语法

PIRP WdfRequestWdmGetIrp(
  [in] WDFREQUEST Request
);

参数

[in] Request

框架请求对象的句柄。

返回值

WdfRequestWdmGetIrp 返回指向 IRP 结构的指针。

如果驱动程序提供无效的对象句柄,则会发生 bug 检查。

言论

完成 I/O 请求后,驱动程序不得访问请求的 IRP 结构。

有关 WdfRequestWdmGetIrp的详细信息,请参阅 获取有关 I/O 请求的信息。

例子

下面的代码示例是 EvtIoDeviceControl 回调函数的一部分,该函数获取与 I/O 请求关联的 WDM IRP,然后调用 IoGetNextIrpStackLocation 以获取下一个较低驱动程序的 I/O 堆栈位置。

VOID
MyEvtIoDeviceControl(
    IN WDFQUEUE  Queue,
    IN WDFREQUEST  Request,
    IN size_t  OutputBufferLength,
    IN size_t  InputBufferLength,
    IN ULONG  IoControlCode
    )
{
    PIRP  irp = NULL;
    PIO_STACK_LOCATION  nextStack;
...
    irp = WdfRequestWdmGetIrp(Request);
    nextStack = IoGetNextIrpStackLocation(irp);
...
}

要求

要求 价值
目标平台 普遍
最低 KMDF 版本 1.0
标头 wdfrequest.h (包括 Wdf.h)
Wdf01000.sys(请参阅框架库版本控制。
IRQL <=DISPATCH_LEVEL
DDI 符合性规则 DriverCreate(kmdf)InvalidReqAccess(kmdf)InvalidReqAccessLocal(kmdf)KmdfIrql(kmdf)KmdfIrql2(kmdf),KmdfIrqlExplicit(kmdf)

另请参阅

WdfRequestGetParameters