WDF_REQUEST_REUSE_PARAMS_SET_NEW_IRP関数 (wdfrequest.h)

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

要件

要件	値
対象プラットフォーム	ユニバーサル
最小 KMDF バージョン	1.0
最小 UMDF バージョン	2.0
Header	wdfrequest.h (Wdf.h を含む)

こちらもご覧ください

WDF_REQUEST_REUSE_PARAMS

WDF_REQUEST_REUSE_PARAMS_INIT

WdfRequestReuse