IAdapterPowerManagement ::QueryPowerChangeState, méthode (portcls.h)
La méthode QueryPowerChangeState 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. Le 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 de retour
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 QueryPowerChangeState pour le compte du système pour interroger le pilote de l’adaptateur pour obtenir l’acceptabilité d’une modification potentielle de l’état de l’alimentation de l’appareil. Le pilote peut refuser la modification de l’état de l’alimentation en retournant une valeur autre que STATUS_SUCCESS. Un appel à QueryPowerStateChange n’est pas garanti avant tous les appels PowerChangeState.
Le code de cette méthode doit résider dans la mémoire paginée.
Exigences
| Exigence | Valeur |
|---|---|
| plateforme cible | Universel |
| d’en-tête | portcls.h (include Portcls.h) |