Метод IAdapterPowerManagement::QueryPowerChangeState (portcls.h)
Метод QueryPowerChangeState вызывается PortCls в ответ на получение IRP_MN_QUERY_POWER power IRP.
Синтаксис
NTSTATUS QueryPowerChangeState(
[in] POWER_STATE NewStateQuery
);
Параметры
[in] NewStateQuery
Указывает новое состояние питания, запрашиваемое для устройства. Этот параметр представляет собой объединение типов POWER_STATE. Новое состояние питания (NewStateQuery.DeviceState) может быть одним из значений перечисления DEVICE_POWER_STATE, перечисленных в IAdapterPowerManagement::P owerChangeStateState.
Возвращаемое значение
QueryPowerChangeState возвращает STATUS_SUCCESS, если вызов выполнен успешно. В противном случае метод возвращает соответствующий код ошибки.
Замечания
PortCls вызывает метод QueryPowerChangeState от имени системы, чтобы запросить драйвер адаптера для обеспечения допустимости возможного изменения состояния питания устройства. Драйвер может запретить изменение состояния питания, возвращая значение, отличное от STATUS_SUCCESS. Вызов QueryPowerStateChange не гарантируется до всех вызовов PowerChang eState.
Код этого метода должен находиться в памяти страниц.
Требования
| Требование | Ценность |
|---|---|
| целевая платформа | Всеобщий |
| заголовка | portcls.h (include Portcls.h) |