WDF_REQUEST_REUSE_PARAMS構造体 (wdfrequest.h)

[アーティクル]
02/27/2024

[KMDF と UMDF に適用]

WDF_REQUEST_REUSE_PARAMS構造体は、再利用された I/O 要求に関連付けられている情報を指定します。

構文

typedef struct _WDF_REQUEST_REUSE_PARAMS {
  ULONG    Size;
  ULONG    Flags;
  NTSTATUS Status;
  PIRP     NewIrp;
} WDF_REQUEST_REUSE_PARAMS, *PWDF_REQUEST_REUSE_PARAMS;

メンバー

Size

この構造体のサイズ (バイト単位)。

Flags

1 つ以上の WDF_REQUEST_REUSE_FLAGS型指定フラグのビットごとの OR。

Status

フレームワークが要求に割り当てる NTSTATUS 値。

NewIrp

IRP 構造体へのポインター。このメンバーの値は省略可能であり、 NULL にすることができます。

注釈

WDF_REQUEST_REUSE_PARAMS構造体は、WdfRequestReuse への入力として使用されます。

この構造体を初期化するには、ドライバーが WDF_REQUEST_REUSE_PARAMS_INIT を呼び出す必要があります。構造体に NewIrp 値を設定するには、ドライバーが WDF_REQUEST_REUSE_PARAMS_INIT を呼び出した後にWDF_REQUEST_REUSE_PARAMS_SET_NEW_IRPを呼び出す必要があります。

下位ドライバーが Status 値にアクセスする必要がある場合は、Irp-IoStatus.Status> フィールドで見つけることができます。

NewIrp 値は、WdfRequestReuse に指定した I/O 要求が WdfRequestCreate または WdfRequestCreateFromIrp を呼び出して作成された場合にのみ設定できます。