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 结尾的 Unicode 字符串的指针，该字符串命名要从注册表中检索的值项。有关详细信息，请参阅备注部分。

IsParameterFileName

如果值为 TRUE，则通常返回的数据值被视为文件名。在这种情况下，将返回该文件的缓冲内容，而不是参数本身。

GetRegistryRoutine

指向微型端口驱动程序的 HwVidQueryNamedValueCallback 函数的指针。

Context

指向要传递给 CallbackRoutine（通常是 VIDEO_PORT_CONFIG_INFO 缓冲区）的调用方确定的上下文参数的指针。

返回值

如果 VideoPortGetRegistryParameters 成功收集了请求的信息并调用了微型端口驱动程序的 HwVidQueryNamedValueCallback 函数，则返回NO_ERROR;否则返回ERROR_INVALID_PARAMETER。

注解

无法从微型端口驱动程序的 HwVidInterrupt 或 HwVidTimer 函数、VideoPortQueueDpc 或从 VideoPortSynchronizeExecution 的回调调用 VideoPortGetRegistryParameters。

对于 Windows XP 和更高版本的操作系统， ParameterName 参数可以包含一个路径，该路径完全引用 适配器 密钥下方的一个或多个级别的值名称。例如，字符串“SubKey1\Value1”可用于获取 SubKey1 子项下的 Value1 值编号的值条目。

VideoPortGetRegistryParameters 从中检索配置信息的注册表项不能包含有关相应显示驱动程序的任何信息，因为微型端口驱动程序 HwVidFindAdapter 函数在加载任何显示驱动程序之前执行。

微型端口驱动程序不应查询 存储在 DefaultSettings 条目中的配置信息，后者在更高版本的操作系统中可能不受支持。

要求

要求	值
最低受支持的客户端	适用于 Windows 2000 及更高版本的 Windows 操作系统。
目标平台	桌面
标头	video.h (包括 Video.h)
Library	Videoprt.lib
DLL	Videoprt.sys
IRQL	PASSIVE_LEVEL