Fonction PcRequestNewPowerState (portcls.h)
La fonction PcRequestNewPowerState est utilisée pour demander un nouvel état d’alimentation pour l’appareil. Cette fonction n’est généralement pas nécessaire par 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, PowerDeviceD2ou PowerDeviceD3.
Valeur de retour
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-élément 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 de l’alimentation | Signification |
|---|---|
| PowerDeviceD0 | État de puissance totale |
| PowerDeviceD1 | État de veille avec la latence d’alimentation la plus faible |
| PowerDeviceD2 | État de veille à latence moyenne |
| PowerDeviceD3 | État de mise en veille prolongée complète et état de veille avec la latence d’alimentation la plus longue |
Le matériel est accessible uniquement à l’état d’alimentation PowerDeviceD0. Dans un autre état, le pilote doit mettre en cache toutes les tentatives d’accès 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.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum 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érieurs. |
| plateforme cible | Universel |
| d’en-tête | portcls.h (include Portcls.h) |
| bibliothèque | Portcls.lib |
| IRQL | PASSIVE_LEVEL |