VideoPortEnumerateChildren-Funktion (video.h)
Die VideoPortEnumerateChildren-Funktion ermöglicht es einem Video-Miniporttreiber, eine Neuzählung seiner untergeordneten Geräte zu erzwingen.
Syntax
VIDEOPORT_DEPRECATED VIDEOPORT_API VP_STATUS VideoPortEnumerateChildren(
[in] IN PVOID HwDeviceExtension,
[in] IN PVOID Reserved
);
Parameter
[in] HwDeviceExtension
Zeiger auf die Geräteerweiterung des Miniporttreibers.
[in] Reserved
Muss auf NULL festgelegt werden.
Rückgabewert
VideoPortEnumerateChildren gibt NO_ERROR zurück.
Hinweise
Einige Geräte erzeugen einen Interrupt, wenn neue Hardware mit dem System verbunden ist oder wenn vorhandene Hardware vom System getrennt ist. Für diese Geräte kann VideoPortEnumerateChildren solche Systemänderungen so nahtlos wie möglich vornehmen. Folgendes ist ein mögliches Szenario, das die Neuzählung untergeordneter Geräte über VideoPortEnumerateChildren erzwingt:
- Neue Hardware ist verbunden, wodurch ein Interrupt generiert wird.
- Der Interrupthandler (HwVidInterrupt) des Miniporttreibers stellt eine DPC-Routine (HwVidDpcRoutine) in die Warteschlange, indem VideoPortQueueDpc aufgerufen wird.
- Der asynchron ausgeführte DPC enthält einen Aufruf von VideoPortEnumerateChildren.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Verfügbar in Windows 2000 und höheren Versionen der Windows-Betriebssysteme. |
| Zielplattform | Desktop |
| Kopfzeile | video.h (einschließen von Video.h) |
| Bibliothek | Videoprt.lib |
| DLL | Videoprt.sys |
| IRQL | <= DISPATCH_LEVEL |