IWDFIoRequest::SetCompletionCallback-Methode (wudfddi.h)

  • Artikel

[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

IRequestCallbackRequestCompletion::OnCompletion

IWDFIoRequest

IWDFIoRequest::Send