IRemoteInterfaceCallbackRemoval ::OnRemoteInterfaceRemoval, méthode (wudfddi.h)
[Avertissement : UMDF 2 est la dernière version de UMDF et remplace UMDF 1. Tous les nouveaux pilotes UMDF doivent être écrits à l’aide de UMDF 2. Aucune nouvelle fonctionnalité n’est ajoutée à UMDF 1 et il existe une prise en charge limitée de UMDF 1 sur les versions plus récentes de Windows 10. Les pilotes Windows universels doivent utiliser UMDF 2. Pour plus d’informations, consultez Bien démarrer avec UMDF.]
La fonction de rappel d’événement du pilote UMDF OnRemoteInterfaceRemoval 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
Aucun
Remarques
La fonction de rappel d’événement OnRemoteInterfaceRemoval du pilote doit effectuer les tâches spécifiques au pilote nécessaires pour gérer la suppression de l’interface de l’appareil. En outre, le rappel doit supprimer l’objet d’interface distante qui IWDFDevice2 ::CreateRemoteInterface créé 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 qui IWDFDevice2 ::CreateRemoteInterface créé.
Pour plus d’informations sur la fonction de rappel d’événements OnRemoteInterfaceRemoval d’un pilote, consultez Utilisation des interfaces de périphérique dans les pilotes basés sur UMDF.
Exigences
| Exigence | Valeur |
|---|---|
| fin du support | Indisponible dans UMDF 2.0 et versions ultérieures. |
| plateforme cible | Bureau |
| version minimale de UMDF | 1.9 |
| d’en-tête | wudfddi.h (include Wudfddi.h) |
Voir aussi
IPnpCallbackRemoteInterfaceNotification ::OnRemoteInterfaceArrival