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
| Anforderung | Wert |
|---|---|
| Zielplattform- | Universal |
| Minimale KMDF-Version | 1.0 |
| Mindest-UMDF-Version | 2.0 |
| Header- | wdfrequest.h (include Wdf.h) |
| Library | Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF) |
| IRQL- | <=DISPATCH_LEVEL |
| DDI-Complianceregeln | DriverCreate(kmdf), InvalidReqAccess(kmdf), InvalidReqAccessLocal(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf) |