Funzione VideoPortEnumerateChildren (video.h)
La funzione VideoPortEnumerateChildren consente a un driver miniport video di forzare una rinumerazione dei dispositivi figlio.
Sintassi
VIDEOPORT_DEPRECATED VIDEOPORT_API VP_STATUS VideoPortEnumerateChildren(
[in] IN PVOID HwDeviceExtension,
[in] IN PVOID Reserved
);
Parametri
[in] HwDeviceExtension
Puntatore all'estensione del dispositivo del driver miniport.
[in] Reserved
Deve essere impostato su NULL.
Valore restituito
VideoPortEnumerateChildren restituisce NO_ERROR.
Osservazioni
Alcuni dispositivi generano un interrupt quando un nuovo hardware è connesso al sistema o quando l'hardware esistente viene disconnesso dal sistema. Per questi dispositivi, VideoPortEnumerateChildren può apportare tali modifiche di sistema il più possibile. Di seguito è riportato uno scenario possibile che forza la rinumerazione dei dispositivi figlio tramite VideoPortEnumerateChildren:
- Il nuovo hardware è connesso, che genera un interrupt.
- Il gestore interrupt del driver miniport (HwVidInterrupt) accoda una routine DPC (HwVidDpcRoutine) chiamando VideoPortQueueDpc.
- Il DPC eseguito in modo asincrono contiene una chiamata a VideoPortEnumerateChildren.
Fabbisogno
| Requisito | Valore |
|---|---|
| client minimo supportato | Disponibile in Windows 2000 e versioni successive dei sistemi operativi Windows. |
| piattaforma di destinazione | Desktop |
| intestazione | video.h (includere Video.h) |
| libreria | Videoprt.lib |
| dll | Videoprt.sys |
| IRQL | <= DISPATCH_LEVEL |