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

  • Article

Tente d’envoyer un événement IRP_MN_STOP_DEVICE à l’appareil cible et d’affecter de nouvelles ressources à l’appareil cible.

Syntaxe

HRESULT EDTTryStopDeviceRequestNewResources(
  [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.
 
À l’instar de la méthode EDTTryStopDevice , EDTTryStopDeviceRequestNewResources tente de déclencher un rééquilibrage des ressources PnP (par exemple, IRP_MN_STOP_DEVICE) sur la pile d’appareils cible, en ajoutant que la méthode tente de forcer l’appareil sur un nouvel ensemble de ressources matérielles.

L’IRP Stop n’est pas garanti. D’autres pilotes de la pile peuvent faire échouer l’événement IRP_MN_QUERY_STOP_DEVICE qui précède l’IRP d’arrêt (ce qui entraîne 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 EDTTryStopDeviceRequestNewResources 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