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) |