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

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

Syntaxe

HRESULT EDTTryStopDeviceFailRestart(
  [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

EDTTryStopDeviceFailRestart tente de déclencher un rééquilibrage des ressources PnP (séquence d’arrêt, d’arrêt et de démarrage de la requête) dans laquelle il échoue à l’événement IRP_MN_START_DEVICE qui suit un arrêt et un arrêt de requête réussis. L’échec de l’IRP de démarrage entraîne la suppression surprise de l’appareil (IRP_MN_SURPRISE_REMOVAL).

L’IRP Stop n’est pas garanti. D’autres pilotes de la pile peuvent échouer un événement de IRP_MN_QUERY_STOP_DEVICE qui précède l’IRP d’arrêt (entraînant une 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 échec de démarrage, vous pouvez à la place exécuter la méthode EDTTryStopDeviceFailRestart 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.

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