Méthode IPnpCallback ::OnQueryRemove (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 méthode OnQueryRemove avertit un pilote avant qu’un appareil ne soit supprimé d’un ordinateur.

Syntaxe

HRESULT OnQueryRemove(
  [in] IWDFDevice *pWdfDevice
);

Paramètres

[in] pWdfDevice

Pointeur vers l’interface IWDFDevice pour l’objet d’appareil de l’appareil qui sera supprimé.

Valeur retournée

Si le pilote détermine que l’appareil peut être arrêté et supprimé, la méthode de rappel OnQueryRemove doit retourner S_OK ou un autre code status pour lequel SUCCEEDED(status) est égal à TRUE. Dans le cas contraire, il doit retourner un code status pour lequel SUCCEEDED(status) est égal à FALSE. Les codes d’erreur HRESULT sont définis dans Winerror.h. Ne retournez pas HRESULT_FROM_NT(STATUS_NOT_SUPPORTED).

Cette méthode doit utiliser la macro HRESULT_FROM_NT pour retourner une valeur HRESULT spécifique afin de renvoyer status à un client en mode noyau. Pour plus d’informations, consultez Prise en charge des clients en mode noyau.

Remarques

Un pilote inscrit l’interface IPnpCallback lorsqu’il appelle la méthode IWDFDriver ::CreateDevice pour créer un objet d’appareil.

L’infrastructure ne synchronise pas la fonction de rappel OnQueryRemove avec d’autres fonctions de rappel PnP et de gestion de l’alimentation.

Pour plus d’informations sur la méthode de rappel OnQueryRemove , consultez Un utilisateur débranche un appareil.

Configuration requise

Condition requise	Valeur
Plateforme cible	Windows
En-tête	wudfddi.h (inclure Wudfddi.h)

Voir aussi

IPnpCallback

IWDFDevice

IWDFDriver ::CreateDevice