WDF_REQUEST_REUSE_PARAMS_SET_NEW_IRP 函数 (wdfrequest.h)

项目
08/08/2023

[适用于 KMDF 和 UMDF]

WDF_REQUEST_REUSE_PARAMS_SET_NEW_IRP 函数在驱动程序的WDF_REQUEST_REUSE_PARAMS结构中设置新的 IRP。

语法

void WDF_REQUEST_REUSE_PARAMS_SET_NEW_IRP(
  [in, out] PWDF_REQUEST_REUSE_PARAMS Params,
  [in]      PIRP                      NewIrp
);

参数

[in, out] Params

指向调用方提供的 WDF_REQUEST_REUSE_PARAMS 结构的指针。

[in] NewIrp

指向调用方提供的 IRP 结构的指针。

返回值

无

备注

如果驱动程序对 WdfRequestReuse 的调用指定了新的 IRP 结构，则驱动程序必须先调用 WDF_REQUEST_REUSE_PARAMS_INIT ，然后调用 WDF_REQUEST_REUSE_PARAMS_SET_NEW_IRP 以初始化WDF_REQUEST_REUSE_PARAMS结构。

WDF_REQUEST_REUSE_PARAMS_SET_NEW_IRP 函数将结构的 NewIrp 成员设置为指定的 IRP 指针。它还在结构的 Flag 成员中设置WDF_REQUEST_REUSE_SET_NEW_IRP标志。

示例

下面的代码示例初始化 WDF_REQUEST_REUSE_PARAMS 结构，为 I/O 请求提供新的 IRP 结构，然后调用 WdfRequestReuse。

WDF_REQUEST_REUSE_PARAMS  params;
NTSTATUS  status;
PIRP  myIrp;
...
WDF_REQUEST_REUSE_PARAMS_INIT(
                              &params,
                              WDF_REQUEST_REUSE_NO_FLAGS,
                              STATUS_SUCCESS
                              );
WDF_REQUEST_REUSE_PARAMS_SET_NEW_IRP(
                                     &params,
                                     myIrp
                                     );
status = WdfRequestReuse(
                         Request,
                         &params
                         );
...