IWDTFPNPAction2 ::EDTTryStopDeviceFailRestart, méthode (wdtfpnpaction.h)

Tente d’envoyer un événement IRP_MN_STOP_DEVICE à l’appareil cible, puis échoue le redémarrage de l’appareil suivant.

Syntaxe

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

Paramètres

[out, retval] pbSuccess

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

Valeur de retour

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

Remarques

Remarque la méthode IWDTFEnhancedDeviceTestSupportAction2 ::Enable doit être appelée pour l’appareil cible avant d’appeler cette méthode.

 

EDTTryStopDeviceFailRestart tente de déclencher un rééquilibrage de ressource PnP (une séquence d’arrêt de requête, d’arrêt, de démarrage d’IRP) dans laquelle il échoue l’événement IRP_MN_START_DEVICE qui suit un arrêt de requête et un arrêt de requête réussis. L’IRP de démarrage a échoué, à son tour, provoque la surprise du système de supprimer l’appareil (IRP_MN_SURPRISE_REMOVAL).

L’IRP Stop n’est pas garanti. D’autres pilotes sur la pile peuvent échouer à un événement IRP_MN_QUERY_STOP_DEVICE qui précède l’IRP Stop (entraînant 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 avec un démarrage ayant échoué, vous pouvez exécuter à la place les EDTTryStopDeviceFailRestart méthode 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 cette méthode sur le contrôleur USB parent à la place.

Exigences

Exigence	Valeur
client minimum pris en charge	Windows XP Professionnel
serveur minimum pris en charge	Windows Server 2008
plateforme cible	Bureau
d’en-tête	wdtfpnpaction.h

Voir aussi

IWDTFPNPAction2