IRemoteInterfaceCallbackRemoval::OnRemoteInterfaceRemoval-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 für neuere 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 OnRemoteInterfaceRemoval-Ereignisrückruffunktion eines UMDF-basierten Treibers benachrichtigt den Treiber darüber, dass er keine Geräteschnittstelle verwenden kann, da die Schnittstelle entfernt wurde.

Syntax

void OnRemoteInterfaceRemoval(
  [in] IWDFRemoteInterface *pWdfRemoteInterface
);

Parameter

[in] pWdfRemoteInterface

Ein Zeiger auf die IWDFRemoteInterface-Schnittstelle eines Remoteschnittstellenobjekts, das eine Geräteschnittstelle darstellt. Der Treiber ruft diesen Zeiger ab, wenn er IWDFDevice2::CreateRemoteInterface aufruft.

Rückgabewert

Keine

Bemerkungen

Die OnRemoteInterfaceRemoval-Ereignisrückruffunktion eines Treibers muss alle treiberspezifischen Aufgaben ausführen, die zum Entfernen der Geräteschnittstelle erforderlich sind. Darüber hinaus muss der Rückruf das von IWDFDevice2::CreateRemoteInterface erstellte Remoteschnittstellenobjekt löschen und die Release-Funktion der Schnittstelle aufrufen, wenn es zuvor die AddRef-Funktion der Schnittstelle aufgerufen hat.

Wenn der Treiber diese Rückruffunktion nicht bereitstellt, löscht das Framework das von IWDFDevice2::CreateRemoteInterface erstellte Remoteschnittstellenobjekt.

Weitere Informationen zur OnRemoteInterfaceRemoval-Ereignisrückruffunktion eines Treibers finden Sie unter Verwenden von Geräteschnittstellen in UMDF-basierten Treibern.

Anforderungen

Weitere Informationen

IPnpCallbackRemoteInterfaceNotification::OnRemoteInterfaceArrival

IRemoteInterfaceCallbackEvent::OnRemoteInterfaceEvent

IRemoteInterfaceCallbackRemoval