функция обратного вызова PVIDEO_HW_POWER_GET (video.h)
HwVidGetPowerState запрашивает, может ли устройство поддерживать запрошенное состояние питания.
Синтаксис
PVIDEO_HW_POWER_GET PvideoHwPowerGet;
VP_STATUS PvideoHwPowerGet(
PVOID HwDeviceExtension,
ULONG HwId,
PVIDEO_POWER_MANAGEMENT VideoPowerControl
)
{...}
Параметры
HwDeviceExtension
Указатель на область хранения минипорта для каждого адаптера. Дополнительные сведения см. в расширениях устройств.
HwId
Указатель на 32-разрядный идентификатор устройства , который однозначно определяет устройство, которое должен запрашивать драйвер минипорта. Этот параметр возвращается функцией HwVidGetVideoChildDescriptor драйвера минипорта. Кроме того, значение DISPLAY_ADAPTER_HW_ID указывает, что данные питания запрашиваются для самого адаптера.
VideoPowerControl
Указатель на структуру VIDEO_POWER_MANAGEMENT, указывающую состояние питания, для которого запрашивается поддержка.
Возвращаемое значение
HwVidGetPowerState возвращает одно из следующих значений:
| Возвращаемый код | Описание |
|---|---|
| NO_ERROR | Устройство поддерживает запрошенное состояние питания. |
| ERROR_DEVICE_REINITIALIZATION_NEEDED | Драйвер не удалось выполнить запрос состояния питания. |
Замечания
HwVidGetPowerState является обязательной функцией в драйвере видеопорта.
Драйвер должен проверить идентификатор, указанный в HwId, чтобы определить, какое устройство запрашивать. Затем драйвер должен определить, поддерживает ли это устройство состояние питания, указанное в элементе PowerState структуры VIDEO_POWER_MANAGEMENT, к которой точки VideoPowerControl.
Эта функция не должна возвращать текущее состояние питания устройства.
HwVidGetPowerState должен быть доступен для страницы.
Требования
| Требование | Ценность |
|---|---|
| целевая платформа | Настольный |
| заголовка | video.h (include Video.h) |