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 （include Video.h）
库	Videoprt.lib
DLL	Videoprt.sys
IRQL	<= DISPATCH_LEVEL