WDF_REQUEST_REUSE_PARAMS_SET_NEW_IRP-Funktion (wdfrequest.h)

Artikel
02/27/2024

[Gilt für KMDF und UMDF]

Die WDF_REQUEST_REUSE_PARAMS_SET_NEW_IRP-Funktion legt einen neuen IRP in der WDF_REQUEST_REUSE_PARAMS-Struktur eines Treibers fest.

Syntax

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

Keine

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

Im folgenden Codebeispiel wird eine WDF_REQUEST_REUSE_PARAMS-Struktur initialisiert, eine neue IRP-Struktur für die E/A-Anforderung bereitgestellt und anschließend WdfRequestReuse aufgerufen.

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