Функция VideoPortGetRegistryParameters (video.h)
Функция 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.
Комментарии
VideoPortGetRegistryParameters нельзя вызывать из функций HwVidInterrupt или HwVidTimer драйвера мини-порта, из VideoPortQueueDpc или обратного вызова VideoPortSynchronizeExecution.
Для 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 |