IWDFIoRequest::SetCompletionCallback-Methode (wudfddi.h)
[Warnung: UMDF 2 ist die neueste Version von UMDF und ersetzt UMDF 1. Alle neuen UMDF-Treiber sollten mit UMDF 2 geschrieben werden. UMDF 1 werden keine neuen Features hinzugefügt, und die Unterstützung für UMDF 1 in neueren Versionen von Windows 10 ist eingeschränkt. Universelle Windows-Treiber müssen UMDF 2 verwenden. Weitere Informationen finden Sie unter Erste Schritte mit UMDF.]
Die SetCompletionCallback-Methode registriert die Schnittstelle für die OnCompletion-Methode , die das Framework aufrufen soll, wenn eine E/A-Anforderung abgeschlossen wird.
Syntax
void SetCompletionCallback(
[in] IRequestCallbackRequestCompletion *pCompletionCallback,
[in, optional] void *pContext
);
Parameter
[in] pCompletionCallback
Ein Zeiger auf die IRequestCallbackRequestCompletion-Schnittstelle , deren OnCompletion-Methode das Framework nach Abschluss der E/A-Anforderung aufruft. Ab Version 1.9 von UMDF kann der Treiber NULL angeben, um die Registrierung einer zuvor registrierten OnCompletion-Methode aufzuheben.
[in, optional] pContext
Ein Zeiger auf einen Puffer, der Kontextinformationen enthält, die sich auf den Abschluss der Anforderung beziehen. Das Framework übergibt diese Kontextinformationen in einem Aufruf der IRequestCallbackRequestCompletion::OnCompletion-Methode . Dieser Parameter ist optional und kann NULL sein.
Rückgabewert
Keine
Bemerkungen
Wenn ein Treiber, der eine E/A-Anforderung weiterleitet, eine Benachrichtigung benötigt, wenn der Treiber auf niedrigerer Ebene die Anforderung abgeschlossen hat, kann der Treiber eine Vervollständigungsroutine bereitstellen und SetCompletionCallback aufrufen, um die IRequestCallbackRequestCompletion-Schnittstelle für die Vervollständigungsroutine zu registrieren. Das Framework ruft die Vervollständigungsroutine auf, nachdem der Treiber auf niedrigerer Ebene die E/A-Anforderung abgeschlossen hat.
Beispiele
Ein Codebeispiel für die Verwendung der SetCompletionCallback-Methode finden Sie unter IWDFIoRequest::Send.
Anforderungen
| Anforderung | Wert |
|---|---|
| Ende des Supports | In UMDF 2.0 und höher nicht verfügbar. |
| Zielplattform | Desktop |
| UMDF-Mindestversion | 1.5 |
| Kopfzeile | wudfddi.h (include Wudfddi.h) |
| DLL | WUDFx.dll |
Weitere Informationen
IRequestCallbackRequestCompletion