Функция 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 не будет восстановлено.

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

Требования

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

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

DEVICE_OBJECT