IOCTL_VIDEO_SET_CHILD_STATE_CONFIGURATION IOCTL (ntdvertitaeo.h)

Articolo
08/07/2023

Esegue un commutatore del dispositivo di visualizzazione, una modifica dello stato in cui il segnale video che passa a un dispositivo di visualizzazione viene inviato a un altro, possibilmente diverso tipo di dispositivo di visualizzazione. Dopo il commutatore del dispositivo di visualizzazione, il segnale video può essere inviato a uno o entrambi i dispositivi di visualizzazione. Quando il driver della porta video riceve una notifica per cambiare i dispositivi di visualizzazione, invia questo IOCTL al driver miniport. In genere, questo IOCTL viene inviato dopo IOCTL_VIDEO_VALIDATE_CHILD_STATE_CONFIGURATION indica che il driver miniport è pronto per eseguire il commutatore. Se il driver miniport è in grado di cambiare i dispositivi di visualizzazione, deve farlo e impostare il membro Status di StatusBlock su NO_ERROR.

Se il driver miniport non è in grado di eseguire l'opzione del dispositivo di visualizzazione, può impostare il membro Status di StatusBlock su un valore di errore appropriato (descritto nella sezione StatusBlock ), scegliendo di non gestire la richiesta. Sebbene questa richiesta sia facoltativa, è consigliabile che il driver miniport gestisca questa richiesta. In caso contrario, forza una chiamata al BIOS per gestire il commutatore del dispositivo di visualizzazione, che può essere molto inefficiente e può avere un effetto negativo sull'affidabilità del sistema.

IOCTL_VIDEO_SET_CHILD_STATE_CONFIGURATION è sincrono. Dopo l'invio di questo IOCTL, IOCTL_VIDEO_GET_CHILD_STATE deve riflettere il nuovo stato.

Questa richiesta è modale.

Codice principale

IRP_MJ_DEVICE_CONTROL

Buffer di input

InputBuffer VRP contiene una struttura VIDEO_CHILD_STATE_CONFIGURATION.

Buffer di output

Nessuno

Blocco dello stato

Il driver miniport imposta il membro Status su NO_ERROR se è in grado di eseguire il commutatore del dispositivo di visualizzazione. Se non è in grado di eseguire questa operazione, il driver miniport può impostare Status su un valore di errore appropriato o non eseguire alcuna operazione.