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

Статья
08/08/2023

Функция VideoPortGetRegistryParameters извлекает сведения о конфигурации устройства в разделе адаптера в реестре при запуске.

Синтаксис

VIDEOPORT_API VP_STATUS VideoPortGetRegistryParameters(
       PVOID                          HwDeviceExtension,
  [in] PWSTR                          ParameterName,
       UCHAR                          IsParameterFileName,
       PMINIPORT_GET_REGISTRY_ROUTINE GetRegistryRoutine,
       PVOID                          Context
);

Параметры

HwDeviceExtension

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

[in] ParameterName

Указатель на строку Юникода с завершением NULL, которая называет запись значения, извлекаемую из реестра. Дополнительные сведения см. в разделе Примечания .

IsParameterFileName

Если значение равно TRUE, обычно возвращаемое значение данных обрабатывается как имя файла. В этом случае возвращается буферизованное содержимое этого файла, а не сам параметр.

GetRegistryRoutine

Указатель на функцию HwVidQueryNamedValueCallback драйвера мини-порта.

Context

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

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

VideoPortGetRegistryParameters возвращает NO_ERROR, если он успешно собрал запрошенные сведения и вызвал функцию HwVidQueryNamedValueCallback драйвера miniport; в противном случае возвращает ERROR_INVALID_PARAMETER.

Для Windows XP и более поздних версий операционной системы параметр ParameterName может содержать путь, который точно ссылается на имя значения одного или нескольких уровней ниже ключа адаптера . Например, строку "SubKey1\Value1" можно использовать для получения записи значения для номера значения Value1 в подразделе SubKey1.

Раздел реестра, из которого VideoPortGetRegistryParameters получает сведения о конфигурации, не может содержать никаких сведений о соответствующем драйвере дисплея, так как функции HwVidFindAdapter драйвера мини-порта выполняются перед загрузкой драйвера дисплея.

Драйверы мини-портов не должны запрашивать сведения о конфигурации, хранящиеся в записях DefaultSettings , которые могут не поддерживаться в более поздних версиях операционной системы.

Требования

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