VideoPortEnumerateChildren, fonction (video.h)

La fonction VideoPortEnumerateChildren permet à un pilote de miniport vidéo de forcer l’énumération de ses appareils enfants.

Syntaxe

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

Paramètres

[in] HwDeviceExtension

Pointeur vers l’extension de périphérique du pilote miniport.

[in] Reserved

Doit être défini sur NULL.

Valeur retournée

VideoPortEnumerateChildren retourne NO_ERROR.

Remarques

Certains appareils génèrent une interruption quand un nouveau matériel est connecté au système ou lorsque du matériel existant est déconnecté du système. Pour ces appareils, VideoPortEnumerateChildren peut rendre ces modifications système aussi transparentes que possible. Voici un scénario possible qui force la rééumation des appareils enfants via VideoPortEnumerateChildren :

• Le nouveau matériel est connecté, ce qui génère une interruption.
• Le gestionnaire d’interruptions du pilote miniport (HwVidInterrupt) met en file d’attente une routine DPC (HwVidDpcRoutine) en appelant VideoPortQueueDpc.
• Le DPC exécuté de manière asynchrone contient un appel à VideoPortEnumerateChildren.

VideoPortEnumerateChildren provoque l’appel de HwVidGetVideoChildDescriptor, ce qui permet au gestionnaire de Plug-and-Play d’énumérer tous les appareils enfants de l’adaptateur.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Disponible dans Windows 2000 et versions ultérieures des systèmes d’exploitation Windows.
Plateforme cible	Desktop (Expérience utilisateur)
En-tête	video.h (incluez Video.h)
Bibliothèque	Videoprt.lib
DLL	Videoprt.sys
IRQL	<= DISPATCH_LEVEL

Voir aussi

HwVidDpcRoutine

HwVidGetVideoChildDescriptor

HwVidInterrupt

VideoPortQueueDpc