VideoPortEnumerateChildren function (video.h)

The VideoPortEnumerateChildren function allows a video miniport driver to force a reenumeration of its child devices.

Syntax

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

Parameters

[in] HwDeviceExtension

Pointer to the miniport driver's device extension.

[in] Reserved

Must be set to NULL.

Return value

VideoPortEnumerateChildren returns NO_ERROR.

Remarks

Some devices generate an interrupt when new hardware is connected to the system, or when existing hardware is disconnected from the system. For these devices, VideoPortEnumerateChildren can make such system changes as seamless as possible. The following is one possible scenario that forces the reenumeration of child devices through VideoPortEnumerateChildren:

• New hardware is connected, which generates an interrupt.
• The miniport driver's interrupt handler (HwVidInterrupt) queues a DPC routine (HwVidDpcRoutine) by calling VideoPortQueueDpc.
• The asynchronously executed DPC contains a call to VideoPortEnumerateChildren.

Requirements

See also

HwVidDpcRoutine

HwVidGetVideoChildDescriptor

HwVidInterrupt

VideoPortQueueDpc