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.
| É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 |