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.
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 |