IOCTL_VIDEO_SET_CHILD_STATE_CONFIGURATION IOCTL (ntddvdeo.h)

Artículo
02/29/2024

Realiza un conmutador de dispositivo de pantalla, un cambio de estado en el que la señal de vídeo que va a un dispositivo de pantalla se envía a otro, posiblemente un tipo diferente de dispositivo de visualización. Después del conmutador de dispositivo de pantalla, la señal de vídeo se puede enviar a uno o ambos dispositivos de visualización. Cuando el controlador de puerto de vídeo recibe una notificación para cambiar los dispositivos de visualización, envía este IOCTL al controlador de minipuerto. Normalmente, este IOCTL se envía después de IOCTL_VIDEO_VALIDATE_CHILD_STATE_CONFIGURATION indica que el controlador de miniporte está listo para hacer el conmutador. Si el controlador de minipuerto es capaz de cambiar los dispositivos de pantalla, debe hacerlo y establecer el miembro Status de StatusBlock en NO_ERROR.

Si el controlador de miniporte no es capaz de realizar el conmutador de dispositivo de visualización, puede establecer el miembro Status de StatusBlock en un valor de error adecuado (descrito en la sección StatusBlock ), eligiendo no controlar la solicitud. Aunque esta solicitud es opcional, se recomienda encarecidamente que el controlador de miniporte controle esta solicitud. Si no lo hace, se fuerza una llamada al BIOS para controlar el conmutador del dispositivo de pantalla, que puede ser muy ineficaz y puede tener un efecto adverso en la solidez del sistema.

IOCTL_VIDEO_SET_CHILD_STATE_CONFIGURATION es sincrónica. Después de enviar este IOCTL, IOCTL_VIDEO_GET_CHILD_STATE debe reflejar el nuevo estado.

Esta solicitud es modal.

Código principal

IRP_MJ_DEVICE_CONTROL

Búfer de entrada

InputBuffer de VRP contiene una estructura de VIDEO_CHILD_STATE_CONFIGURATION.

Búfer de salida

None

Bloque de estado

El controlador de minipuerto establece el miembro Status en NO_ERROR si es capaz de realizar el conmutador de dispositivo de pantalla. Si no puede llevar a cabo esta operación, el controlador de minipuerto puede establecer Estado en un valor de error adecuado o no hacer nada en absoluto.