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值请求的数据类型,通常为 VpBusData、 VpControllerData 或 VpMonitorData 之一。
VpControllerData 和 VpMonitorData 值仅在符合 ARC 的平台上相关。 x86 类型视频适配器的微型端口驱动程序通常指定 VpBusData,尤其是对于 EISA 总线上的适配器。 VpMachineData 值保留供将来使用。
CallbackRoutine
指向要使用请求的信息调用的驱动程序提供的 HwVidQueryDeviceCallback 函数的指针。
Context
指向要传递给 CallbackRoutine 的调用方确定的上下文参数的指针。 它通常指向 VIDEO_PORT_CONFIG_INFO 缓冲区。
返回值
如果 VideoPortGetDeviceData 使用配置信息成功调用了微型端口驱动程序的 HwVidQueryDeviceCallback 函数,则它将返回NO_ERROR。
注解
无法从微型端口驱动程序的 HwVidInterrupt 或 HwVidTimer 函数、VideoPortQueueDpc 或从 VideoPortSynchronizeExecution 的回调调用 VideoPortGetDeviceData。
VideoPortGetDeviceData 从中检索配置信息的注册表树是易失性的;也就是说,每次加载系统时,系统加载程序或 HAL 都会重新创建它。 由于此信息是在启动过程的早期收集和存储的, 因此 VideoPortGetBusData 返回的与总线相关的配置信息可能更完整。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | 在 Windows 2000 及更高版本的 Windows 操作系统中可用。 |
目标平台 | 桌面 |
标头 | video.h (包括 Video.h) |
Library | Videoprt.lib |
DLL | Videoprt.sys |
IRQL | PASSIVE_LEVEL |