IAdapterPowerManagement::QueryPowerChangeState-Methode (portcls.h)

Die QueryPowerChangeState -Methode wird von PortCls als Reaktion auf den Empfang eines IRP_MN_QUERY_POWER Power-IRP aufgerufen.

Syntax

NTSTATUS QueryPowerChangeState(
  [in] POWER_STATE NewStateQuery
);

Parameter

[in] NewStateQuery

Gibt den neuen Energiezustand an, der für das Gerät angefordert wird. Dieser Parameter ist eine Union vom Typ POWER_STATE. Der neue Energiezustand (NewStateQuery.DeviceState) kann einer der DEVICE_POWER_STATE Enumerationswerte sein, die in IAdapterPowerManagement::P owerChangeState aufgeführt sind.

Rückgabewert

QueryPowerChangeState gibt STATUS_SUCCESS zurück, wenn der Aufruf erfolgreich war. Andernfalls gibt die Methode einen entsprechenden Fehlercode zurück.

Hinweise

PortCls ruft die QueryPowerChangeState -Methode im Namen des Systems auf, um den Adaptertreiber auf Zulässigkeit einer möglichen Änderung des Energiezustands des Geräts abzufragen. Der Treiber kann die Änderung des Energiezustands verweigern, indem er einen anderen Wert als STATUS_SUCCESS zurückgibt. Es ist nicht garantiert, dass vor allen PowerChangeState-Aufrufen ein Aufruf QueryPowerStateChange von erfolgt.

Der Code für diese Methode muss sich im ausgelagerten Arbeitsspeicher befinden.

Anforderungen

Anforderung	Wert
Zielplattform	Universell
Header	portcls.h (include Portcls.h)

Weitere Informationen

IAdapterPowerManagement

IAdapterPowerManagement::P owerChangeState

IRP_MN_QUERY_POWER