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. 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 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
Keine
Bemerkungen
Ein UMDF-basierter Treiber kann seine optionale OnRemoteInterfaceArrival-Ereignisrückruffunktion registrieren, indem er IWDFDevice2::RegisterRemoteInterfaceNotification aufruft.
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 die folgenden Schritte ausführen:
- Rufen Sie IWDFDevice2::CreateRemoteInterface auf, um ein Remoteschnittstellenobjekt zu erstellen.
- Rufen Sie IWDFDevice2::CreateRemoteTarget auf, um ein Remotezielobjekt zu erstellen.
- Rufen Sie IWDFRemoteTarget::OpenRemoteInterface auf, um das Schnittstellenobjekt mit dem Remotezielobjekt zu verbinden und das Remoteziel für E/A-Vorgänge zu öffnen.
Anforderungen
| Anforderung | Wert |
|---|---|
| Ende des Supports | In UMDF 2.0 und höher nicht verfügbar. |
| Zielplattform | Desktop |
| UMDF-Mindestversion | 1.9 |
| Kopfzeile | wudfddi.h (include Wudfddi.h) |
Weitere Informationen
IPnpCallbackRemoteInterfaceNotification
IWDFDevice2::CreateRemoteInterface