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

Статья
02/29/2024

Функция 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 получает сведения о конфигурации, является переменным; то есть он повторно создается системным загрузчиком или HAL при каждой загрузке системы. Так как эти сведения собираются и хранятся в начале процесса загрузки, сведения о конфигурации относительно шины, возвращаемые VideoPortGetBusData , могут быть более полными.

Требования

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

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

HwVidFindAdapter

HwVidQueryDeviceCallback

VIDEO_PORT_CONFIG_INFO

VideoPortGetRegistryParameters

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