Поделиться через

Функция VideoPortGetDeviceData (video.h)

  • Статья

Функция VideoPortGetDeviceData извлекает сведения о конфигурации, обнаруженные системой, из . \Machine\Hardware\Description tree в реестре. Эти сведения зависят от шины или адаптера и хранятся в реестре системным загрузчиком или HAL.

Синтаксис

VIDEOPORT_DEPRECATED VIDEOPORT_API VP_STATUS VideoPortGetDeviceData(
  PVOID                          HwDeviceExtension,
  VIDEO_DEVICE_DATA_TYPE         DeviceDataType,
  PMINIPORT_QUERY_DEVICE_ROUTINE CallbackRoutine,
  PVOID                          Context
);

Параметры

HwDeviceExtension

Указатель на расширение устройства драйвера мини-порта.

DeviceDataType

Указывает тип данных, запрашиваемых в качестве значения VIDEO_DEVICE_DATA_TYPE, как правило, VpBusData, VpControllerData или VpMonitorData.

Значения VpControllerData и VpMonitorData актуальны только на платформах, совместимых с ARC. Драйверы мини-портов для видеоадаптеров типа x86 обычно указывают VpBusData, особенно для адаптеров на автобусах EISA. Значение VpMachineData зарезервировано для использования в будущем.

CallbackRoutine

Указатель на функцию HwVidQueryDeviceCallback , предоставляемую драйвером, для вызова с запрошенными сведениями.

Context

Указатель на определяемый вызывающим параметром контекста, который передается в CallbackRoutine. Обычно он указывает на буфер VIDEO_PORT_CONFIG_INFO .

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

VideoPortGetDeviceData возвращает NO_ERROR, если он успешно вызвал функцию HwVidQueryDeviceCallback драйвера miniport со сведениями о конфигурации.

Комментарии

VideoPortGetDeviceData нельзя вызывать из функций HwVidInterrupt или HwVidTimer драйвера мини-порта, из VideoPortQueueDpc или обратного вызова VideoPortSynchronizeExecution.

Дерево реестра, из которого VideoPortGetDeviceData получает сведения о конфигурации, является переменным; то есть он повторно создается системным загрузчиком или HAL при каждой загрузке системы. Так как эти сведения собираются и хранятся в начале процесса загрузки, сведения о конфигурации относительно шины, возвращаемые VideoPortGetBusData , могут быть более полными.

Требования

Требование Значение
Минимальная версия клиента Доступно в Windows 2000 и более поздних версиях операционных систем Windows.
Целевая платформа Персональный компьютер
Верхняя часть video.h (включая Video.h)
Библиотека Videoprt.lib
DLL Videoprt.sys
IRQL PASSIVE_LEVEL

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

HwVidFindAdapter

HwVidQueryDeviceCallback

VIDEO_PORT_CONFIG_INFO

VideoPortGetRegistryParameters