Méthode IRemoteInterfaceCallbackRemoval ::OnRemoteInterfaceRemoval (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 OnRemoteInterfaceRemoval d’un pilote UMDF informe le pilote qu’il ne peut pas utiliser une interface de périphérique , car l’interface a été supprimée.
Syntaxe
void OnRemoteInterfaceRemoval(
[in] IWDFRemoteInterface *pWdfRemoteInterface
);
Paramètres
[in] pWdfRemoteInterface
Pointeur vers l’interface IWDFRemoteInterface d’un objet d’interface distante qui représente une interface d’appareil. Le pilote obtient ce pointeur lorsqu’il appelle IWDFDevice2 ::CreateRemoteInterface.
Valeur de retour
None
Remarques
La fonction de rappel d’événement OnRemoteInterfaceRemoval d’un pilote doit effectuer toutes les tâches spécifiques au pilote nécessaires pour gérer la suppression de l’interface de périphérique. En outre, le rappel doit supprimer l’objet d’interface distante créé par IWDFDevice2 ::CreateRemoteInterface et appeler la fonction Release de l’interface si elle a précédemment appelé la fonction AddRef de l’interface.
Si le pilote ne fournit pas cette fonction de rappel, l’infrastructure supprime l’objet d’interface distante créé par IWDFDevice2 ::CreateRemoteInterface .
Pour plus d’informations sur la fonction de rappel d’événement OnRemoteInterfaceRemoval d’un pilote, consultez Utilisation d’interfaces de périphérique dans les pilotes basés sur UMDF.
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 ::OnRemoteInterfaceArrival