WdfRequestGetCompletionParams-Funktion (wdfrequest.h)
[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) |