Partager via


VideoPortEnumerateChildren, fonction (video.h)

La fonction VideoPortEnumerateChildren permet à un pilote de miniport vidéo de forcer une réumation 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 de retour

VideoPortEnumerateChildren retourne NO_ERROR.

Remarques

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

  • Un 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 Plug-and-Play d’énumérer tous les appareils enfants de l’adaptateur.

Exigences

Exigence Valeur
client minimum pris en charge Disponible dans Windows 2000 et versions ultérieures des systèmes d’exploitation Windows.
plateforme cible Bureau
d’en-tête video.h (include Video.h)
bibliothèque Videoprt.lib
DLL Videoprt.sys
IRQL <= DISPATCH_LEVEL

Voir aussi

HwVidDpcRoutine

HwVidGetVideoChildDescriptor

HwVidInterrupt

VideoPortQueueDpc