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
ヘッダー	wdfrequest.h (Wdf.h を含む)

関連項目

WDF_REQUEST_REUSE_PARAMS

WDF_REQUEST_REUSE_PARAMS_INIT

WdfRequestReuse