Partager via


IPnpCallback ::OnQueryStop, 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 méthode OnQueryStop avertit un pilote avant l’arrêt d’un appareil.

Syntaxe

HRESULT OnQueryStop(
  [in] IWDFDevice *pWdfDevice
);

Paramètres

[in] pWdfDevice

Pointeur vers l’interface IWDFDevice pour l’objet d’appareil de l’appareil qui sera arrêté.

Valeur de retour

Si le pilote détermine que l’appareil peut être arrêté, la méthode de rappel OnQueryStop doit retourner S_OK ou un autre code d’état pour lequel SUCCEEDED(status) est égal TRUE. Sinon, il doit retourner un code d’état 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 pour retourner l’état à 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 OnQueryStop avec d’autres fonctions de rappel PnP et de gestion de l’alimentation.

OnQueryStop n’est pas appelé dans les versions 1.7 et antérieures du framework.

Pour plus d’informations sur la méthode de rappel OnQueryStop, consultez Les ressources système redistribuées PnP Manager.

Exigences

Exigence Valeur
plateforme cible Windows
d’en-tête wudfddi.h (include Wudfddi.h)

Voir aussi

IPnpCallback

IWDFDevice

IWDFDriver ::CreateDevice