WDF_REQUEST_REUSE_PARAMS-Struktur (wdfrequest.h)

Artikel
02/29/2024

[Gilt für KMDF und UMDF]

Die WDF_REQUEST_REUSE_PARAMS-Struktur gibt Informationen an, die einer wiederverwendeten E/A-Anforderung zugeordnet sind.

Syntax

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

Member

Size

Die Größe (in Bytes) dieser Struktur.

Flags

Ein bitweises OR mit einem oder mehreren WDF_REQUEST_REUSE_FLAGS typisierten Flags.

Status

Ein NTSTATUS-Wert, den das Framework der Anforderung zuweist.

NewIrp

Ein Zeiger auf eine IRP-Struktur . Der Wert dieses Members ist optional und kann NULL sein.

Hinweise

Die WDF_REQUEST_REUSE_PARAMS-Struktur wird als Eingabe für WdfRequestReuse verwendet.

Um diese Struktur zu initialisieren, muss der Treiber WDF_REQUEST_REUSE_PARAMS_INIT aufrufen. Um einen NewIrp-Wert in der -Struktur festzulegen, muss der Treiber WDF_REQUEST_REUSE_PARAMS_SET_NEW_IRP aufrufen, nachdem er WDF_REQUEST_REUSE_PARAMS_INIT aufgerufen hat.

Wenn ein niedrigerer Treiber auf den Statuswert zugreifen muss, kann er ihn im Feld Irp-IoStatus.Status> finden.

Sie können einen NewIrp-Wert nur festlegen, wenn die E/A-Anforderung, die Sie an WdfRequestReuse übermitteln, durch Aufrufen von WdfRequestCreate oder WdfRequestCreateFromIrp erstellt wurde.