функция обратного вызова 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-разрядный идентификатор устройства , который однозначно идентифицирует устройство, к которому должен запрашивать драйвер мини-порта. Этот параметр возвращается функцией HwVidGetVidVideoChildDescriptor драйвера мини-порта. Кроме того, значение 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 (включая Video.h)

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

HwVidGetVideoChildDescriptor

HwVidSetPowerState

VIDEO_POWER_MANAGEMENT