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

IsParameterFileName

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

GetRegistryRoutine

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

Context

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

返回值

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

言论

VideoPortGetRegistryParameters 无法从微型端口驱动程序的 HwVidInterruptHwVidTimer 函数或从 VideoPortQueueDpc调用,也不能从回调调用到 VideoPortSynchronizeExecution

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

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

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

要求

要求 价值
最低支持的客户端 在 Windows 2000 及更高版本的 Windows作系统中可用。
目标平台 桌面
标头 video.h (include Video.h)
Videoprt.lib
DLL Videoprt.sys
IRQL PASSIVE_LEVEL

另请参阅

HwVidFindAdapter

HwVidInitialize

HwVidQueryDeviceCallback

HwVidQueryNamedValueCallback

VIDEO_PORT_CONFIG_INFO

VideoPortFlushRegistry

VideoPortGetDeviceData

VideoPortSetRegistryParameters