Méthode IAdapterPowerManagement ::QueryPowerChangeState (portcls.h)
La QueryPowerChangeState méthode est appelée par PortCls en réponse à la réception d’un IRP d’alimentation IRP_MN_QUERY_POWER .
Syntaxe
NTSTATUS QueryPowerChangeState(
[in] POWER_STATE NewStateQuery
);
Paramètres
[in] NewStateQuery
Spécifie le nouvel état d’alimentation demandé pour l’appareil. Ce paramètre est une union de type POWER_STATE. Nouvel état d’alimentation (NewStateQuery.DeviceState) peut être l’une des valeurs d’énumération DEVICE_POWER_STATE répertoriées dans IAdapterPowerManagement ::P owerChangeState.
Valeur retournée
QueryPowerChangeState retourne STATUS_SUCCESS si l’appel a réussi. Sinon, la méthode retourne un code d’erreur approprié.
Remarques
PortCls appelle la méthode pour le QueryPowerChangeState compte du système pour interroger le pilote de l’adaptateur afin d’obtenir l’acceptabilité d’une modification potentielle de l’état d’alimentation d’un appareil. Le pilote peut refuser le changement d’état d’alimentation en retournant une valeur autre que STATUS_SUCCESS. Il n’est pas garanti qu’un appel à QueryPowerStateChange se produise avant tous les appels PowerChangeState .
Le code de cette méthode doit résider dans la mémoire paginée.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Plateforme cible | Universal |
| En-tête | portcls.h (include Portcls.h) |