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 操作系统中可用。
目标平台 桌面
Header video.h (包括 Video.h)
Library Videoprt.lib
DLL Videoprt.sys
IRQL <= DISPATCH_LEVEL

另请参阅

HwVidDpcRoutine

HwVidGetVideoChildDescriptor

HwVidInterrupt

VideoPortQueueDpc