WDF_REQUEST_REUSE_PARAMS_SET_NEW_IRP函式 (wdfrequest.h)

發行項
02/27/2024

[適用於 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
                         );
...