VideoPortEnumerateChildren 函数 (video.h)

VideoPortEnumerateChildren 函数允许视频微型端口驱动程序强制恢复其子设备。

语法

VIDEOPORT_DEPRECATED VIDEOPORT_API VP_STATUS VideoPortEnumerateChildren(
  [in] IN PVOID HwDeviceExtension,
  [in] IN PVOID Reserved
);

[in] HwDeviceExtension

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

[in] Reserved

必须设置为 NULL。

VideoPortEnumerateChildren 返回NO_ERROR。

当新硬件连接到系统或现有硬件与系统断开连接时，某些设备会生成中断。对于这些设备， VideoPortEnumerateChildren 可以尽可能无缝地进行此类系统更改。下面是通过 VideoPortEnumerateChildren 强制恢复子设备的一种可能方案：

新硬件已连接，这会生成中断。
微型端口驱动程序的中断处理程序 (HwVidInterrupt) 通过调用 VideoPortQueueDpc 将 DPC 例程 (HwVidDpcRoutine) 排队。
异步执行的 DPC 包含对 VideoPortEnumerateChildren 的调用。

VideoPortEnumerateChildren 会导致调用 HwVidGetVideoChildDescriptor，从而允许即插即用管理器枚举适配器的所有子设备。

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