Método IAdapterPowerManagement::QueryPowerChangeState (portcls.h)
O QueryPowerChangeState método é chamado por PortCls em resposta ao recebimento de um IRP de energia de IRP_MN_QUERY_POWER .
Sintaxe
NTSTATUS QueryPowerChangeState(
[in] POWER_STATE NewStateQuery
);
Parâmetros
[in] NewStateQuery
Especifica o novo estado de energia que está sendo solicitado para o dispositivo. Esse parâmetro é uma união do tipo POWER_STATE. O novo estado de energia (NewStateQuery.DeviceState) pode ser um dos valores de enumeração DEVICE_POWER_STATE listados em IAdapterPowerManagement::P owerChangeState.
Retornar valor
QueryPowerChangeState retornará STATUS_SUCCESS se a chamada tiver sido bem-sucedida. Caso contrário, o método retornará um código de erro apropriado.
Comentários
PortCls chama o QueryPowerChangeState método em nome do sistema para consultar o driver do adaptador quanto à aceitabilidade de uma possível alteração de estado de energia do dispositivo. O driver pode negar a alteração do estado de energia retornando um valor diferente de STATUS_SUCCESS. Não há garantia de que uma chamada para QueryPowerStateChange ocorra antes de todas as chamadas do PowerChangeState .
O código para esse método deve residir na memória paginada.
Requisitos
| Requisito | Valor |
|---|---|
| Plataforma de Destino | Universal |
| Cabeçalho | portcls.h (inclua Portcls.h) |