VideoPortGetDeviceData 函数 (video.h)

VideoPortGetDeviceData 函数从 中检索系统检测到的配置信息。注册表中的 \Machine\Hardware\Description 树。 此信息特定于总线或适配器,由系统加载程序或 HAL 存储在注册表中。

语法

VIDEOPORT_DEPRECATED VIDEOPORT_API VP_STATUS VideoPortGetDeviceData(
  PVOID                          HwDeviceExtension,
  VIDEO_DEVICE_DATA_TYPE         DeviceDataType,
  PMINIPORT_QUERY_DEVICE_ROUTINE CallbackRoutine,
  PVOID                          Context
);

参数

HwDeviceExtension

指向微型端口驱动程序的设备扩展的指针。

DeviceDataType

指定要作为VIDEO_DEVICE_DATA_TYPE值请求的数据类型,通常为 VpBusDataVpControllerDataVpMonitorData 之一。

VpControllerDataVpMonitorData 值仅在符合 ARC 的平台上相关。 x86 类型视频适配器的微型端口驱动程序通常指定 VpBusData,尤其是对于 EISA 总线上的适配器。 VpMachineData 值保留供将来使用。

CallbackRoutine

指向要使用请求的信息调用的驱动程序提供的 HwVidQueryDeviceCallback 函数的指针。

Context

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

返回值

如果 VideoPortGetDeviceData 使用配置信息成功调用了微型端口驱动程序的 HwVidQueryDeviceCallback 函数,则它将返回NO_ERROR。

注解

无法从微型端口驱动程序的 HwVidInterruptHwVidTimer 函数、VideoPortQueueDpc 或从 VideoPortSynchronizeExecution 的回调调用 VideoPortGetDeviceData

VideoPortGetDeviceData 从中检索配置信息的注册表树是易失性的;也就是说,每次加载系统时,系统加载程序或 HAL 都会重新创建它。 由于此信息是在启动过程的早期收集和存储的, 因此 VideoPortGetBusData 返回的与总线相关的配置信息可能更完整。

要求

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

另请参阅

HwVidFindAdapter

HwVidQueryDeviceCallback

VIDEO_PORT_CONFIG_INFO

VideoPortGetRegistryParameters