Méthode IPnpCallbackRemoteInterfaceNotification ::OnRemoteInterfaceArrival (wudfddi.h)
[Avertissement : UMDF 2 est la dernière version d’UMDF et remplace UMDF 1. Tous les nouveaux pilotes UMDF doivent être écrits à l’aide d’UMDF 2. Aucune nouvelle fonctionnalité n’est ajoutée à UMDF 1 et la prise en charge d’UMDF 1 est limitée sur les versions plus récentes de Windows 10. Les pilotes Windows universels doivent utiliser UMDF 2. Pour plus d’informations, consultez Prise en main avec UMDF.]
La fonction de rappel d’événement OnRemoteInterfaceArrival d’un pilote informe le pilote lorsqu’une interface de périphérique est disponible.
Syntaxe
void OnRemoteInterfaceArrival(
[in] IWDFRemoteInterfaceInitialize *pWdfRemoteInterfaceInit
);
Paramètres
[in] pWdfRemoteInterfaceInit
Pointeur vers l’interface IWDFRemoteInterfaceInitialize qui identifie l’interface d’appareil arrivée.
Valeur de retour
None
Remarques
Un pilote UMDF peut inscrire sa fonction de rappel d’événement OnRemoteInterfaceArrival facultative en appelant IWDFDevice2 ::RegisterRemoteInterfaceNotification.
Le pilote peut utiliser les méthodes de l’interface IWDFRemoteInterfaceInitialize pour déterminer l’interface d’appareil qui est arrivée.
Avant que le pilote puisse envoyer des demandes d’E/S à l’interface du périphérique, le pilote doit effectuer les opérations suivantes :
- Appelez IWDFDevice2 ::CreateRemoteInterface pour créer un objet d’interface distante.
- Appelez IWDFDevice2 ::CreateRemoteTarget pour créer un objet cible distant.
- Appelez IWDFRemoteTarget ::OpenRemoteInterface pour connecter l’objet d’interface à l’objet cible distant et ouvrir la cible distante pour les opérations d’E/S.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Fin de la prise en charge | Non disponible dans UMDF 2.0 et versions ultérieures. |
| Plateforme cible | Desktop (Expérience utilisateur) |
| Version UMDF minimale | 1,9 |
| En-tête | wudfddi.h (inclure Wudfddi.h) |
Voir aussi
IPnpCallbackRemoteInterfaceNotification
IWDFDevice2 ::CreateRemoteInterface