Expand Minimize

VideoPortEnumerateChildren function

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

Syntax


VP_STATUS VideoPortEnumerateChildren(
  _In_        PVOID HwDeviceExtension,
  _Reserved_  PVOID Reserved
);

Parameters

HwDeviceExtension [in]

Pointer to the miniport driver's device extension.

Reserved [in]

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.

VideoPortEnumerateChildren causes HwVidGetVideoChildDescriptor to be called, allowing the Plug and Play Manager to enumerate all of the adapter's child devices.

Requirements

Version

Available in Windows 2000 and later versions of the Windows operating systems.

Header

Video.h (include Video.h)

Library

Videoprt.lib

DLL

Videoprt.sys

IRQL

<= DISPATCH_LEVEL

See also

HwVidGetVideoChildDescriptor
HwVidInterrupt
HwVidDpcRoutine
VideoPortQueueDpc

 

 

Send comments about this topic to Microsoft

Show:
© 2014 Microsoft. All rights reserved.