WDF_REQUEST_REUSE_PARAMS_SET_NEW_IRP-Funktion (wdfrequest.h)

Artikel
07.02.2025

[Gilt für KMDF und UMDF]

Die WDF_REQUEST_REUSE_PARAMS_SET_NEW_IRP-Funktion legt ein neues IRP in der WDF_REQUEST_REUSE_PARAMS Struktur eines Treibers fest.

Syntax

C++

void WDF_REQUEST_REUSE_PARAMS_SET_NEW_IRP(
  [in, out] PWDF_REQUEST_REUSE_PARAMS Params,
  [in]      PIRP                      NewIrp
);

Parameter

[in, out] Params

Ein Zeiger auf eine vom Aufrufer bereitgestellte WDF_REQUEST_REUSE_PARAMS Struktur.

[in] NewIrp

Ein Zeiger auf eine vom Aufrufer bereitgestellte IRP--Struktur.

Rückgabewert

Nichts

Bemerkungen

Wenn der Aufruf eines Treibers an WdfRequestReuse eine neue IRP-Struktur angibt, muss der Treiber zuerst WDF_REQUEST_REUSE_PARAMS_INIT aufrufen und dann WDF_REQUEST_REUSE_PARAMS_SET_NEW_IRP aufrufen, um eine WDF_REQUEST_REUSE_PARAMS Struktur zu initialisieren.

Die WDF_REQUEST_REUSE_PARAMS_SET_NEW_IRP-Funktion legt den NewIrp Member der Struktur auf den angegebenen IRP-Zeiger fest. Außerdem wird das WDF_REQUEST_REUSE_SET_NEW_IRP Flag im Flag- Element der Struktur festgelegt.

Beispiele

Das folgende Codebeispiel initialisiert eine WDF_REQUEST_REUSE_PARAMS-Struktur, stellt eine neue IRP-Struktur für die E/A-Anforderung bereit und ruft dann WdfRequestReuseauf.

C++

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

Anforderungen

Anforderung	Wert
Zielplattform-	Universal
Minimale KMDF-Version	1.0
Mindest-UMDF-Version	2.0
Header-	wdfrequest.h (include Wdf.h)

Siehe auch

WDF_REQUEST_REUSE_PARAMS

WDF_REQUEST_REUSE_PARAMS_INIT

WdfRequestReuse-

Freigeben über