Méthode IRemoteTargetCallbackRemoval ::OnRemoteTargetQueryRemove (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 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 :
- Effectuez les actions spécifiques au pilote nécessaires pour arrêter les E/S sur la cible distante.
- Appelez IWDFRemoteTarget ::CloseForQueryRemove.
- Retourne TRUE pour indiquer que la suppression peut se produire.
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) |