Méthode IAdapterPowerManagement ::QueryPowerChangeState (portcls.h)

Article
03/01/2024

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.