Fonction PcRequestNewPowerState (portcls.h)

  • Article

La fonction PcRequestNewPowerState permet de demander un nouvel état d’alimentation pour l’appareil. Cette fonction n’est généralement pas nécessaire pour les pilotes d’adaptateur, mais peut parfois être utile pour contourner certains types de problèmes matériels.

Syntaxe

PORTCLASSAPI NTSTATUS PcRequestNewPowerState(
  [in] PDEVICE_OBJECT     pDeviceObject,
  [in] DEVICE_POWER_STATE RequestedNewState
);

Paramètres

[in] pDeviceObject

Pointeur vers l’objet d’appareil fonctionnel (FDO) de l’adaptateur. Ce paramètre doit pointer vers une structure système de type DEVICE_OBJECT.

[in] RequestedNewState

Spécifie l’état d’alimentation de l’appareil demandé. Définissez ce paramètre sur l’une des valeurs d’énumération DEVICE_POWER_STATE suivantes : PowerDeviceD0, PowerDeviceD1, PowerDeviceD2 ou PowerDeviceD3.

Valeur retournée

PcRequestNewPowerState retourne STATUS_SUCCESS si l’appel a réussi. Sinon, retourne un message d’erreur approprié.

Remarques

Un pilote d’adaptateur peut appeler PcRequestNewPowerState pour compenser les défauts de conception matérielle. Par exemple, si les fonctions d’une carte audio ne sont pas mutuellement indépendantes et doivent être arrêtées dans un ordre particulier, l’adaptateur peut appeler PcRequestNewPowerState pour s’assurer qu’un sous-appareil particulier est arrêté en premier.

Le paramètre RequestedNewState peut être défini sur l’une des valeurs d’énumération DEVICE_POWER_STATE dans le tableau suivant.

État d’alimentation Signification
PowerDeviceD0 État d’alimentation totale
PowerDeviceD1 État de veille avec la latence de mise sous tension la plus faible
PowerDeviceD2 État de veille à latence moyenne
PowerDeviceD3 Un état de mise en veille prolongée complète et l’état de veille avec la latence de mise sous tension la plus longue
 

Le matériel est accessible uniquement dans l’état d’alimentation PowerDeviceD0. Dans tout autre état, le pilote doit mettre en cache toutes les tentatives d’accès au matériel et différer ces accès jusqu’à ce que l’état PowerDeviceD0 soit restauré.

Pour plus d’informations, consultez Gestion de l’alimentation pour les appareils audio.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Le pilote système PortCls implémente la fonction PcRequestNewPowerState dans Microsoft Windows 98/Me et dans les systèmes d’exploitation Windows 2000 et ultérieur.
Plateforme cible Universal
En-tête portcls.h (include Portcls.h)
Bibliothèque Portcls.lib
IRQL PASSIVE_LEVEL

Voir aussi

DEVICE_OBJECT