Поделиться через


Метод IAdapterPowerManagement::QueryPowerChangeState (portcls.h)

Метод QueryPowerChangeState вызывается PortCls в ответ на получение IRP IRP_MN_QUERY_POWER питания.

Синтаксис

NTSTATUS QueryPowerChangeState(
  [in] POWER_STATE NewStateQuery
);

Параметры

[in] NewStateQuery

Указывает новое состояние питания, запрашиваемое для устройства. Этот параметр является объединением типа POWER_STATE. Новое состояние питания (NewStateQuery.DeviceState) может быть одним из DEVICE_POWER_STATE значений перечисления, перечисленных в IAdapterPowerManagement::P owerChangeState.

Возвращаемое значение

QueryPowerChangeState возвращает STATUS_SUCCESS, если вызов был успешным. В противном случае метод возвращает соответствующий код ошибки.

Комментарии

PortCls вызывает QueryPowerChangeState метод от имени системы, чтобы запросить у драйвера адаптера допустимость потенциального изменения состояния питания устройства. Драйвер может запретить изменение состояния питания, возвращая значение, отличное от STATUS_SUCCESS. Вызов не QueryPowerStateChange гарантируется до всех вызовов PowerChangeState .

Код для этого метода должен находиться в постраничной памяти.

Требования

Требование Значение
Целевая платформа Универсальное
Верхняя часть portcls.h (включая Portcls.h)

См. также раздел

IAdapterPowerManagement

IAdapterPowerManagement::P owerChangeState

IRP_MN_QUERY_POWER