Metodo IAdapterPowerManagement::QueryPowerChangeState (portcls.h)
Il metodo QueryPowerChangeState viene chiamato da PortCls in risposta alla ricezione di un IRP di alimentazione IRP_MN_QUERY_POWER.
Sintassi
NTSTATUS QueryPowerChangeState(
[in] POWER_STATE NewStateQuery
);
Parametri
[in] NewStateQuery
Specifica il nuovo stato di alimentazione richiesto per il dispositivo. Questo parametro è un'unione di tipo POWER_STATE. Il nuovo stato di alimentazione (NewStateQuery.DeviceState) può essere uno dei valori di enumerazione DEVICE_POWER_STATE elencati in IAdapterPowerManagement::P owerChangeState.
Valore restituito
QueryPowerChangeState restituisce STATUS_SUCCESS se la chiamata ha avuto esito positivo. In caso contrario, il metodo restituisce un codice di errore appropriato.
Osservazioni
PortCls chiama il metodo QueryPowerChangeState per conto del sistema per eseguire una query sul driver dell'adattatore per accettare una potenziale modifica dello stato di alimentazione del dispositivo. Il driver può negare la modifica dello stato di alimentazione restituendo un valore diverso da STATUS_SUCCESS. Non è garantito che venga eseguita una chiamata a QueryPowerStateChange prima di tutte le chiamate PowerChangeState.
Il codice per questo metodo deve risiedere nella memoria di paging.
Fabbisogno
| Requisito | Valore |
|---|---|
| piattaforma di destinazione | Universale |
| intestazione | portcls.h (include Portcls.h) |