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. Es werden keine neuen Features zu UMDF 1 hinzugefügt, und es gibt eingeschränkte Unterstützung für UMDF 1 für neuere Versionen von Windows 10. 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 ist.
Syntax
void SetCompletionCallback(
[in] IRequestCallbackRequestCompletion *pCompletionCallback,
[in, optional] void *pContext
);
Parameter
[in] pCompletionCallback
Ein Zeiger auf die IRequestCallbackRequestCompletion Schnittstelle, deren OnCompletion Methode das Framework aufruft, nachdem die E/A-Anforderung abgeschlossen wurde. Ab Version 1.9 von UMDF kann der Treiber NULL- angeben, um eine zuvor registrierte OnCompletion--Methode zu deregistern.
[in, optional] pContext
Ein Zeiger auf einen Puffer, der Kontextinformationen enthält, die sich auf den Anforderungsabschluss beziehen. Das Framework übergibt diese Kontextinformationen in einem Aufruf der IRequestCallbackRequestCompletion::OnCompletion-Methode. Dieser Parameter ist optional und kann NULL-werden.
Rückgabewert
Nichts
Bemerkungen
Wenn ein Treiber, der eine E/A-Anforderung weiterleitet, eine Benachrichtigung erfordert, wenn der Treiber auf niedrigerer Ebene die Anforderung abgeschlossen hat, kann der Treiber eine Abschlussroutine bereitstellen und SetCompletionCallback- aufrufen, um die IRequestCallbackRequestCompletion Schnittstelle für die Abschlussroutine zu registrieren. Das Framework ruft die Abschlussroutine 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 |
| Mindest-UMDF-Version | 1.5 |
| Header- | wudfddi.h (include Wudfddi.h) |
| DLL- | WUDFx.dll |
Siehe auch
IRequestCallbackRequestCompletion