Méthode IRemoteInterfaceCallbackRemoval ::OnRemoteInterfaceRemoval (wudfddi.h)

  • Article

[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

IRemoteInterfaceCallbackEvent ::OnRemoteInterfaceEvent

IRemoteInterfaceCallbackRemoval