Partager via

Méthode IRemoteTargetCallbackRemoval ::OnRemoteTargetQueryRemove (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 OnRemoteTargetQueryRemove d’un pilote UMDF détermine si l’appareil d’une cible d’E/S distante peut être arrêté et supprimé.

Syntaxe

BOOL OnRemoteTargetQueryRemove(
  [in] IWDFRemoteTarget *pWdfRemoteTarget
);

Paramètres

[in] pWdfRemoteTarget

Pointeur vers l’interface IWDFRemoteTarget d’un objet cible distant qui représente une cible d’E/S distante. Le pilote obtient ce pointeur lorsqu’il appelle IWDFDevice2 ::CreateRemoteTarget.

Valeur retournée

Si le pilote détermine que l’appareil peut être arrêté et supprimé, la fonction de rappel d’événement OnRemoteTargetQueryRemove doit retourner TRUE. Sinon, la fonction de rappel doit retourner FALSE.

Remarques

Si votre pilote fournit une fonction de rappel d’événement OnRemoteTargetQueryRemove , la fonction de rappel doit déterminer si le système d’exploitation doit autoriser la suppression de l’appareil. Si le pilote détermine que l’appareil peut être supprimé, il doit effectuer les opérations suivantes :

  1. Effectuez les actions spécifiques au pilote nécessaires pour arrêter les E/S sur la cible distante.
  2. Appelez IWDFRemoteTarget ::CloseForQueryRemove.
  3. Retourne TRUE pour indiquer que la suppression peut se produire.
Si le pilote détermine que l’appareil ne doit pas être supprimé, la fonction de rappel doit retourner FALSE. En règle générale, les pilotes doivent éviter de renvoyer FALSE, car une valeur de retour FALSE peut entraîner le redémarrage de Windows.

Si le pilote ne fournit pas cette fonction de rappel, l’infrastructure appelle IWDFRemoteTarget ::CloseForQueryRemove pour le pilote. En d’autres termes, l’infrastructure autorise toujours la suppression de l’appareil, sauf si le pilote fournit une fonction de rappel d’événement OnRemoteTargetQueryRemove .

Pour plus d’informations sur la fonction de rappel d’événement OnRemoteTargetQueryRemove , consultez Contrôle de l’état d’une cible d’E/S générale dans 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

IRemoteTargetCallbackRemoval

IRemoteTargetCallbackRemoval ::OnRemoteTargetRemoveCanceled

IRemoteTargetCallbackRemoval ::OnRemoteTargetRemoveComplete