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

Функция VideoPortSetRegistryParameters записывает сведения в раздел адаптера в реестре.

Синтаксис

VIDEOPORT_API VP_STATUS VideoPortSetRegistryParameters(
       PVOID HwDeviceExtension,
  [in] PWSTR ValueName,
  [in] PVOID ValueData,
       ULONG ValueLength
);

Параметры

HwDeviceExtension

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

[in] ValueName

Указатель на буфер, содержащий строку Юникода, завершающуюся null, которая называет запись значения, для которой данные записываются в реестр.

[in] ValueData

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

ValueLength

Указывает размер в байтах данных, записываемых в реестр.

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

VideoPortSetRegistryParameters возвращает NO_ERROR, были ли данные успешно записаны в реестр. В противном случае он может вернуть ERROR_INVALID_PARAMETER.

Комментарии

VideoPortSetRegistryParameters выполняет поиск в разделе адаптера реестра имени значения, указанного в параметре ValueName . Если искомое имя значения не существует, эта функция создает его автоматически. При обнаружении или создании имени значения содержимое параметра ValueData копируется в имя значения.

Для windows XP и более поздних версий операционной системы имя значения, указанное в параметрах ValueName , не обязательно связывать непосредственно с ключом адаптера . Вместо этого ValueName можно связать с подразделом, путь к которому включает ключ адаптера . Если строка ValueName содержит одну или несколько обратных косых черт, VideoPortSetRegistryParameters ищет или создает подраздел, имя которого находится в конце строки.

Например, если параметру ValueName присвоена строка "SubKey1\Value1", эта функция выполняет поиск subKey1 в разделе адаптера в реестре, создавая subKey1, если он не существует. Затем функция ищет имя значения Value1 , создавая его при необходимости. Затем VideoPortSetRegistryParameters копирует содержимое параметра ValueData в реестр. Путь, указанный в параметре ValueName , может ссылаться на имя значения на произвольное количество уровней ниже ключа адаптера , но поведение этой функции по сути совпадает. Если в какой-либо момент подраздел или имя значения не найдено, оно создается автоматически.

В Windows 2000 и более поздних версиях VideoPortSetRegistryParameters возвращает ERROR_INVALID_PARAMETER, если строка, переданная в параметре ValueName , начинается с "DefaultSettings". (обратите внимание, что точка является частью строки). В операционных системах, предшествующих Windows 2000, драйвер видео минипорта может передать имя значения, начинающееся с "DefaultSettings". Чтобы указать разрешение по умолчанию для монитора, но в Windows 2000 и более поздних версиях эта возможность не требуется.

В проверенной сборке любой версии операционной системы имя значения, начинающееся с DefaultSettings, приводит к сбою утверждения.

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

Требования

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

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

HwVidFindAdapter

HwVidInitialize

VideoPortFlushRegistry

VideoPortGetRegistryParameters