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

  • Article

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

Note La méthode IWDTFEnhancedDeviceTestSupportAction2 ::Enable doit être appelée pour l’appareil cible avant d’appeler cette méthode.
 
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