Fonction PcRequestNewPowerState (portcls.h)

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.

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

Voir aussi

DEVICE_OBJECT