PMINIPORT_GET_REGISTRY_ROUTINE回调函数 （video.h）
HwVidQueryNamedValueCallback 处理从注册表检索到的指定数据。
语法
PMINIPORT_GET_REGISTRY_ROUTINE PminiportGetRegistryRoutine;
VP_STATUS PminiportGetRegistryRoutine(
PVOID HwDeviceExtension,
PVOID Context,
PWSTR ValueName,
PVOID ValueData,
ULONG ValueLength
)
{...}
参数
HwDeviceExtension
指向微型端口驱动程序的每个适配器存储区域的指针。 有关详细信息，请参阅 设备扩展。
Context
指向指定为 VideoPortGetRegistryParameters 函数的输入的驱动程序确定上下文的指针。
ValueName
指向以 NULL 结尾的 Unicode 字符串的指针，该字符串命名条目。
ValueData
指向由 videoPortGetRegistryParameters 提供的与 ValueName关联的缓冲数据的指针。
ValueLength
指定 ValueData处缓冲区的大小（以字节为单位）。
返回值
HwVidQueryNamedValueCallback 返回作的状态。
言论
HwVidQueryNamedValueCallback 是一个可选的微型端口驱动程序函数，在调用 VideoPortGetRegistryParameters。
VideoPortGetRegistryParameters 调用 HwVidQueryNamedValueCallback 后，收集注册表 适配器 键中给定的 ValueName 的可用配置信息。
HwVidFindAdapter 或 HwVidInitialize 可以使用驱动程序提供的 HwVidQueryNamedValueCallback 函数调用 VideoPortGetRegistryParameters， 指向设备扩展和任何驱动程序提供的上下文数据的指针（可以是 VIDEO_PORT_CONFIG_INFO 缓冲区），以及指向 Unicode 字符串的指针，用于命名要从注册表检索的值。
HwVidFindAdapter 或 HwVidInitialize 可以将 videoPortGetRegistryParameters 的 IsFileNameParameter 参数设置为 TRUE，前提是驱动程序提供的 Unicode 字符串是名为文件名的注册表项。 对于此规范，返回的数据将是命名文件的内容。
当 VideoPortGetRegistryParameters 调用 HwVidQueryNamedValueCallback 函数时，它将处理可用的任何配置数据。 例如，HwVidQueryNamedValueCallback 可以使用检索的数据来确定微型端口驱动程序的访问范围，并设置其仿真器访问范围（如果有）、中断向量或中断 IRQL（如果有），以及在微型端口驱动程序的设备扩展中 VIDEO_PORT_CONFIG_INFO，然后再将控制权返回到 HwVidFindAdapter 函数。
HwVidInitialize 还可以调用 VideoPortGetRegistryParameters，IsFileNameParameter 设置为 TRUE，以便微型端口驱动程序提供的 HwVidQueryNamedValueCallback 函数可以使用命名文件的缓冲内容在适配器上设置微代码。
返回 ValueData 位于堆栈上，因此可以在本地引用它。 HwVidQueryNamedValueCallback 可以存储输入 HwDeviceExtension 中其他微型端口驱动程序函数使用的一些或全部返回的信息，或使用输入 上下文 作为指向可存储数据的位置的指针。
应 HwVidQueryNamedValueCallback 可分页。
要求
| 要求 | 价值 |
|---|---|
| 目标平台 | 桌面 |
| 标头 | video.h （include Video.h） |