Функция PcRequestNewPowerState (portcls.h)

Функция PcRequestNewPowerState используется для запроса нового состояния питания для устройства. Эта функция обычно не требуется драйверами адаптеров, но иногда может быть полезной при работе с некоторыми видами проблем оборудования.

Синтаксис

PORTCLASSAPI NTSTATUS PcRequestNewPowerState(
  [in] PDEVICE_OBJECT     pDeviceObject,
  [in] DEVICE_POWER_STATE RequestedNewState
);

Параметры

[in] pDeviceObject

Указатель на функционального объекта устройства адаптера (FDO). Этот параметр должен указывать на системную структуру типа DEVICE_OBJECT.

[in] RequestedNewState

Указывает запрашиваемое состояние питания устройства. Задайте для этого параметра одно из следующих значений перечисления DEVICE_POWER_STATE: PowerDeviceD0, PowerDeviceD1, PowerDeviceD2или PowerDeviceD3.

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

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

Замечания

Драйвер адаптера может вызывать PcRequestNewPowerState, чтобы компенсировать недостатки проектирования оборудования. Например, если функции в звуковом адаптере не зависят друг от друга и необходимо завершить работу в определенном порядке, адаптер может вызывать PcRequestNewPowerState, чтобы убедиться, что определенный вложенный объект завершает работу в первую очередь.

Параметр RequestedNewState можно задать для одного из значений перечисления DEVICE_POWER_STATE в следующей таблице.

Состояние питания	Значение
PowerDeviceD0	Полное состояние питания
PowerDeviceD1	Состояние спящего режима с наименьшей задержкой питания
PowerDeviceD2	Состояние спящего режима средней задержки
PowerDeviceD3	Полное состояние гибернации и состояние спящего режима с максимальной задержкой питания

 

Доступ к оборудованию можно получить только в состоянии питания PowerDeviceD0. В любом другом состоянии драйвер должен кэшировать все попытки доступа к оборудованию и отложить эти доступы до тех пор, пока не будет восстановлено Состояние PowerDeviceD0.

Дополнительные сведения см. в разделе Power Management для аудиоустройств.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Системный драйвер PortCls реализует функцию PcRequestNewPowerState в Microsoft Windows 98/Me и в Windows 2000 и более поздних операционных системах.
целевая платформа	Всеобщий
заголовка	portcls.h (include Portcls.h)
библиотеки	Portcls.lib
IRQL	PASSIVE_LEVEL

См. также

DEVICE_OBJECT