video.h) (PMINIPORT_GET_REGISTRY_ROUTINE 回调函数

项目
02/26/2024

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 在收集注册表适配器键中给定 ValueName 的可用配置信息后调用 HwVidQueryNamedValueCallback。

HwVidFindAdapter 或 HwVidInitialize 可以使用驱动程序提供的 HwVidQueryNamedValueCallback 函数、指向设备扩展的指针和驱动程序提供的任何上下文数据 (（可以是VIDEO_PORT_CONFIG_INFO缓冲区) ）调用 VideoPortGetRegistryParameters，以及指向命名要从注册表中检索的值的 Unicode 字符串的指针。

如果驱动程序提供的 Unicode 字符串是名为文件名的注册表项，HwVidFindAdapter 或 HwVidInitialize 可以将 VideoPortGetRegistryParameters 的 IsFileNameParameter 参数设置为 TRUE。对于此规范，返回的数据将是命名文件的内容。

当 VideoPortGetRegistryParameters 调用 HwVidQueryNamedValueCallback 函数时，它会处理提供的任何配置数据。例如， HwVidQueryNamedValueCallback 可能会使用检索到的数据来确定微型端口驱动程序的访问范围，并在将控制权返回到 HwVidFindAdapter 函数之前，在VIDEO_PORT_CONFIG_INFO缓冲区和微型端口驱动程序的设备扩展中设置其模拟器访问范围， (如果) 有任何) 、中断矢量或中断 IRQL (，等等。

HwVidInitialize 还可以调用将 IsFileNameParameter 设置为 TRUE 的 VideoPortGetRegistryParameters，以便微型端口驱动程序提供的 HwVidQueryNamedValueCallback 函数可以使用命名文件的缓冲内容在适配器上设置微代码。

返回的 ValueData 位于堆栈上，因此可以在本地引用它。 HwVidQueryNamedValueCallback 可以存储部分或全部返回的信息，供输入 HwDeviceExtension 中的其他微型端口驱动程序函数使用，或者将输入 上下文 用作指向可存储数据的位置的指针。

应使 HwVidQueryNamedValueCallback 可分页。