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.
Commenti
Alcuni dispositivi generano un'interruzione quando un nuovo hardware è connesso al sistema o quando l'hardware esistente viene disconnesso dal sistema. Per questi dispositivi, VideoPortEnumerateChildren può apportare tali modifiche al sistema il più facilmente 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.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Disponibile in Windows 2000 e versioni successive dei sistemi operativi Windows. |
| Piattaforma di destinazione | Desktop |
| Intestazione | video.h (include Video.h) |
| Libreria | Videoprt.lib |
| DLL | Videoprt.sys |
| IRQL | <= DISPATCH_LEVEL |