WdfRequestGetCompletionParams-Funktion (wdfrequest.h)

[Gilt für KMDF und UMDF]

Die WdfRequestGetCompletionParams Methode ruft die E/A-Abschlussparameter 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 zu einem Framework-Anforderungsobjekt.

[in, out] Params

Ein Zeiger auf eine vom Aufrufer bereitgestellte WDF_REQUEST_COMPLETION_PARAMS Struktur.

Rückgabewert

Nichts

Bemerkungen

Wenn der Treiber ein ungültiges Objekthandle bereitstellt, tritt eine Fehlerüberprüfung auf.

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 abgeschlossen der E/A-Anforderung abgeschlossen wurde, kann der Treiber WdfRequestGetCompletionParams aufrufen, um die E/A-Anforderungsabschlussparameter abzurufen.

Die Struktur der Abschlussparameter enthält nur gültige Informationen, wenn der Treiber die Anforderung formatiert hat, indem eine der WdfIoTargetFormat-Xxx--Methoden aufgerufen wird. Siehe z. B. WdfIoTargetFormatRequestForRead.

Beachten Sie, dass der Treiber, wenn ihr Treiber eine der Methoden aufruft, die E/A-Anforderungen nur synchron an E/A-Ziele sendet (z. B. WdfIoTargetSendReadSynchronously), muss der Treiber nicht aufrufen, WdfRequestGetCompletionParams.

Die WdfRequestGetCompletionParams Methode kopiert die Abschlussparameter 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 WdfRequestGetCompletionParamsfinden Sie unter Abschließen von E/A-Anforderungen.

Beispiele

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

WDF_REQUEST_COMPLETION_PARAMS completionParams;

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

Anforderungen

Siehe auch

CompletionRoutine-

WDF_REQUEST_COMPLETION_PARAMS

WDF_REQUEST_COMPLETION_PARAMS_INIT