WdfRequestGetCompletionParams-Funktion (wdfrequest.h)

Artikel
02/27/2024

[Gilt für KMDF und UMDF]

Die WdfRequestGetCompletionParams-Methode ruft die E/A-Vervollständigungsparameter ab, die einem angegebenen Frameworkanforderungsobjekt zugeordnet sind.

Syntax

void WdfRequestGetCompletionParams(
  [in]      WDFREQUEST                     Request,
  [in, out] PWDF_REQUEST_COMPLETION_PARAMS Params
);

Parameter

[in] Request

Ein Handle für ein Frameworkanforderungsobjekt.

[in, out] Params

Ein Zeiger auf eine vom Aufrufer bereitgestellte WDF_REQUEST_COMPLETION_PARAMS-Struktur .

Rückgabewert

Keine

Bemerkungen

Eine Fehlerüberprüfung tritt auf, wenn der Treiber ein ungültiges Objekthandle bereitstellt.

Nachdem ein Treiber WdfRequestSend aufgerufen hat, um eine E/A-Anforderung synchron oder asynchron an ein E/A-Ziel zu senden, und nachdem das E/A-Ziel die E/A-Anforderung abgeschlossen hat, kann der Treiber WdfRequestGetCompletionParams aufrufen, um die Vervollständigungsparameter der E/A-Anforderung abzurufen.

Die Vervollständigungsparameterstruktur enthält nur gültige Informationen, wenn der Treiber die Anforderung durch Aufrufen einer der WdfIoTargetFormatXxx-Methoden formatiert hat. Weitere Informationen finden Sie beispielsweise unter WdfIoTargetFormatRequestForRead.

Wenn Ihr Treiber eine der Methoden aufruft, die E/A-Anforderungen nur synchron an E/A-Ziele sendet (z. B. WdfIoTargetSendReadSynchronously), darf der Treiber WdfRequestGetCompletionParamsnicht aufrufen.

Die WdfRequestGetCompletionParams-Methode kopiert die Vervollständigungsparameter der E/A-Anforderung in die angegebene WDF_REQUEST_COMPLETION_PARAMS-Struktur .

Wenn ein Treiber eine E/A-Anforderung asynchron sendet, ruft er diese Methode in der Regel innerhalb einer CompletionRoutine-Rückruffunktion auf.

Weitere Informationen zu WdfRequestGetCompletionParams finden Sie unter Abschließen von E/A-Anforderungen.

Beispiele

Im folgenden Codebeispiel wird eine WDF_REQUEST_COMPLETION_PARAMS-Struktur initialisiert und dann WdfRequestGetCompletionParams aufgerufen.

WDF_REQUEST_COMPLETION_PARAMS completionParams;

WDF_REQUEST_COMPLETION_PARAMS_INIT(&completionParams);
WdfRequestGetCompletionParams(
                              request,
                              &completionParams
                              );

Anforderungen

Anforderung	Wert
Zielplattform	Universell
KMDF-Mindestversion	1.0
UMDF-Mindestversion	2.0
Kopfzeile	wdfrequest.h (einschließen von Wdf.h)
Bibliothek	Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF)
IRQL	<=DISPATCH_LEVEL
DDI-Complianceregeln	DriverCreate(kmdf), InvalidReqAccess(kmdf), InvalidReqAccessLocal(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

Weitere Informationen

CompletionRoutine

WDF_REQUEST_COMPLETION_PARAMS

WDF_REQUEST_COMPLETION_PARAMS_INIT

Share via