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

Artículo
02/26/2024

QueryPowerChangeState PortCls llama al método en respuesta a la recepción de un IRP de energía IRP_MN_QUERY_POWER.

Sintaxis

NTSTATUS QueryPowerChangeState(
  [in] POWER_STATE NewStateQuery
);

Parámetros

[in] NewStateQuery

Especifica el nuevo estado de alimentación que se solicita para el dispositivo. Este parámetro es una unión de tipo POWER_STATE. Nuevo estado de energía (NewStateQuery.DeviceState) puede ser uno de los valores de enumeración de DEVICE_POWER_STATE enumerados en IAdapterPowerManagement::P owerChangeState.

Valor devuelto

QueryPowerChangeState devuelve STATUS_SUCCESS si la llamada se realizó correctamente. De lo contrario, el método devuelve un código de error adecuado.

Comentarios

PortCls llama al QueryPowerChangeState método en nombre del sistema para consultar al controlador del adaptador para que pueda aceptar un posible cambio de estado de energía del dispositivo. El controlador puede denegar el cambio de estado de energía devolviendo un valor distinto de STATUS_SUCCESS. No se garantiza que se produzca una llamada a QueryPowerStateChange antes de todas las llamadas a PowerChangeState .

El código de este método debe residir en la memoria paginada.