VideoPortEnumerateChildren-Funktion (video.h)

Artikel
02/07/2025

Mit der VideoPortEnumerateChildren--Funktion kann ein Videominiporttreiber eine Erneuteumeration seiner untergeordneten Geräte erzwingen.

Syntax

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

Parameter

[in] HwDeviceExtension

Zeigen Sie auf die Geräteerweiterung des Miniporttreibers.

[in] Reserved

Muss auf NULL-festgelegt sein.

Rückgabewert

VideoPortEnumerateChildren gibt NO_ERROR zurück.

Bemerkungen

Einige Geräte generieren eine Unterbrechung, wenn neue Hardware mit dem System verbunden ist, oder wenn vorhandene Hardware vom System getrennt wird. Für diese Geräte können VideoPortEnumerateChildren solche Systemänderungen so nahtlos wie möglich vornehmen. Es folgt ein mögliches Szenario, das die Erneuteumeration untergeordneter Geräte durch VideoPortEnumerateChildrenerzwingt:

Neue Hardware ist verbunden, wodurch ein Interrupt generiert wird.
Der Interrupthandler des Miniporttreibers (HwVidInterrupt) stellt eine DPC-Routine (HwVidDpcRoutine) in die Warteschlange ein, indem VideoPortQueueDpcaufgerufen wird.
Der asynchron ausgeführte DPC enthält einen Aufruf von VideoPortEnumerateChildren.

VideoPortEnumerateChildren bewirkt, dass HwVidGetVideoChildDescriptor aufgerufen werden, sodass der Plug- und Play-Manager alle untergeordneten Geräte des Adapters auflisten kann.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Verfügbar in Windows 2000 und höheren Versionen von Windows-Betriebssystemen.
Zielplattform-	Desktop
Header-	video.h (video.h einschließen)
Library	Videoprt.lib
DLL-	Videoprt.sys
IRQL-	<= DISPATCH_LEVEL

Siehe auch

HwVidDpcRoutine

HwVidGetVideoChildDescriptor-

HwVidInterrupt

VideoPortQueueDpc

Freigeben über