Функция 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 |