IPnpCallbackRemoteInterfaceNotification::OnRemoteInterfaceArrival-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 OnRemoteInterfaceArrival Ereignisrückruffunktion eines Treibers informiert den Treiber, wenn eine Geräteschnittstelle verfügbar ist.

Syntax

void OnRemoteInterfaceArrival(
  [in] IWDFRemoteInterfaceInitialize *pWdfRemoteInterfaceInit
);

Parameter

[in] pWdfRemoteInterfaceInit

Ein Zeiger auf die IWDFRemoteInterfaceInitialize Schnittstelle, die die eingetroffene Geräteschnittstelle identifiziert.

Rückgabewert

Nichts

Bemerkungen

Ein UMDF-basierter Treiber kann seine optionale OnRemoteInterfaceArrival Ereignisrückruffunktion registrieren, indem IWDFDevice2::RegisterRemoteInterfaceNotificationaufgerufen wird.

Der Treiber kann Methoden der IWDFRemoteInterfaceInitialize Schnittstelle verwenden, um zu bestimmen, welche Geräteschnittstelle eingetroffen ist.

Bevor der Treiber E/A-Anforderungen an die Geräteschnittstelle senden kann, muss der Treiber folgendes ausführen:

1. Rufen Sie IWDFDevice2::CreateRemoteInterface- auf, um ein Remoteschnittstellenobjekt zu erstellen.
2. Rufen Sie IWDFDevice2::CreateRemoteTarget- auf, um ein Remotezielobjekt zu erstellen.
3. Rufen Sie IWDFRemoteTarget::OpenRemoteInterface auf, um das Schnittstellenobjekt mit dem Remotezielobjekt zu verbinden und das Remoteziel für E/A-Vorgänge zu öffnen.

Weitere Informationen zur Verwendung von Remoteschnittstellenobjekten für den Zugriff auf Geräteschnittstellen finden Sie unter Verwenden von Geräteschnittstellen in UMDF-basierten Treibern

Anforderungen

Anforderung	Wert
Ende des Supports	In UMDF 2.0 und höher nicht verfügbar.
Zielplattform-	Desktop
Mindest-UMDF-Version	1.9
Header-	wudfddi.h (include Wudfddi.h)

Siehe auch

IPnpCallbackRemoteInterfaceNotification

IWDFDevice2::CreateRemoteInterface

IWDFDevice2::CreateRemoteTarget

IWDFRemoteInterfaceInitialize

IWDFRemoteTarget::OpenRemoteInterface