WDF_REQUEST_REUSE_PARAMS 結構 (wdfrequest.h)

發行項
02/29/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

一個或多個 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。

如果較低的驅動程式需要存取 [狀態] 值，則可以在 [Irp-IoStatus.Status>] 字段中找到它。

只有在您提供給 WdfRequestReuse 的 I/O 要求是藉由呼叫 WdfRequestCreate 或 WdfRequestCreateFromIrp 來建立時，才可以設定 NewIrp 值。