WdfRequestSetCompletionRoutine-Funktion (wdfrequest.h)
[Gilt für KMDF und UMDF]
Die WdfRequestSetCompletionRoutine-Methode registriert oder hebt die Registrierung einer Vervollständigungsroutine für das angegebene Frameworkanforderungsobjekt auf.
Syntax
void WdfRequestSetCompletionRoutine(
[in] WDFREQUEST Request,
[in, optional] PFN_WDF_REQUEST_COMPLETION_ROUTINE CompletionRoutine,
[in, optional] __drv_aliasesMem WDFCONTEXT CompletionContext
);
Parameter
[in] Request
Ein Handle für ein Frameworkanforderungsobjekt.
[in, optional] CompletionRoutine
Ein Zeiger auf eine CompletionRoutine-Rückruffunktion , wenn der Treiber eine Vervollständigungsroutine registriert, oder NULL des Treibers die Registrierung einer zuvor registrierten Vervollständigungsroutine auf hebt.
[in, optional] CompletionContext
Ein nicht typisierter Zeiger auf vom Treiber definierte Kontextinformationen, die das Framework an die Rückruffunktion CompletionRoutine übergibt. Dieser Parameter ist optional und kann NULL sein.
Rückgabewert
Keine
Bemerkungen
Eine Fehlerüberprüfung tritt auf, wenn der Treiber ein ungültiges Objekthandle bereitstellt.
Wenn Ihr Treiber E/A-Anforderungen weiterleitet, aber wenn Sie möchten, dass Ihr Treiber benachrichtigt wird, wenn ein Treiber auf niedrigerer Ebene die Anforderung abgeschlossen hat, kann Ihr Treiber eine CompletionRoutine-Rückruffunktion bereitstellen und WdfRequestSetCompletionRoutine aufrufen, um die Funktion zu registrieren. Das Framework ruft die Rückruffunktion auf, nachdem ein Treiber auf niedrigerer Ebene die E/A-Anforderung abgeschlossen hat.
Weitere Informationen zu WdfRequestSetCompletionRoutine finden Sie unter Abschließen von E/A-Anforderungen.
Beispiele
Ein Codebeispiel, das WdfRequestSetCompletionRoutine verwendet, finden Sie unter WdfRequestSend.
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), ReqCompletionRoutine(kmdf) |