Méthode IWDTFPNPAction2 ::EDTTryStopDevice (wdtfpnpaction.h)

Tente d’envoyer un événement IRP_MN_STOP_DEVICE à l’appareil cible.

Syntaxe

HRESULT EDTTryStopDevice(
  [out, retval] VARIANT_BOOL *pbSuccess
);

Paramètres

[out, retval] pbSuccess

True si l’opération réussit ; sinon, false.

Valeur retournée

Si cette méthode réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.

Remarques

EDTTryStopDevice tente de déclencher un rééquilibrage des ressources PnP (par exemple, IRP_MN_STOP_DEVICE) sur la pile de l’appareil cible. L’IRP Stop n’est pas garanti. D’autres pilotes de la pile peuvent échouer l’événement IRP_MN_QUERY_STOP_DEVICE qui précède l’IRP d’arrêt (entraînant un événement IRP_MN_CANCEL_STOP_DEVICE). En outre, le système peut optimiser s’il détecte que l’appareil cible n’utilise pas de ressources matérielles (par exemple, une souris USB) et envoie un IRP CancelStop à la place.

Si votre appareil ne consomme pas de ressources matérielles, mais que vous souhaitez toujours essayer de tester la façon dont les pilotes et les applications gèrent le rééquilibrage des ressources PnP, vous pouvez à la place exécuter la méthode EDTTryStopDevice sur un appareil parent, grand-parent, etc., qui consomme des ressources matérielles. Par exemple, si votre appareil est une souris USB, vous pouvez exécuter EDTTryStopDevice sur le contrôleur USB parent à la place.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows XP Professionnel
Serveur minimal pris en charge	Windows Server 2008
Plateforme cible	Desktop (Expérience utilisateur)
En-tête	wdtfpnpaction.h

Voir aussi

IWDTFPNPAction2