IOCTL_VIDEO_SET_CHILD_STATE_CONFIGURATION IOCTL (ntddvdeo.h)
Executa uma opção de dispositivo de exibição, uma alteração de estado na qual o sinal de vídeo que vai para um dispositivo de vídeo é enviado para outro, possivelmente um tipo diferente de dispositivo de vídeo. Após a opção de dispositivo de exibição, o sinal de vídeo pode ser enviado para um ou ambos os dispositivos de exibição. Quando o driver de porta de vídeo recebe uma notificação para alternar dispositivos de exibição, ele envia esse IOCTL para o driver de miniporta. Normalmente, esse IOCTL é enviado após IOCTL_VIDEO_VALIDATE_CHILD_STATE_CONFIGURATION indica que o driver de miniporta está pronto para fazer a troca. Se o driver de miniporta for capaz de alternar dispositivos de exibição, ele deverá fazer isso e definir o membro Status de StatusBlock como NO_ERROR.
Se o driver de miniporto não for capaz de executar a opção de dispositivo de exibição, ele poderá definir o membro Status de StatusBlock para um valor de erro apropriado (descrito na seção StatusBlock ), optando por não manipular a solicitação. Embora essa solicitação seja opcional, é altamente recomendável que o driver de miniporte lide com essa solicitação. Não fazer isso força uma chamada ao BIOS para lidar com o comutador de dispositivo de exibição, que pode ser muito ineficiente e pode ter um efeito adverso na robustez do sistema.
IOCTL_VIDEO_SET_CHILD_STATE_CONFIGURATION é síncrono. Depois que esse IOCTL for enviado, IOCTL_VIDEO_GET_CHILD_STATE deverá refletir o novo estado.
Essa solicitação é modal.
Código principal
Buffer de entrada
O InputBuffer vrp contém uma estrutura VIDEO_CHILD_STATE_CONFIGURATION .
Buffer de saída
Nenhum
Bloco de status
O driver de miniporta define o membro Status como NO_ERROR se ele for capaz de executar o comutador de dispositivo de exibição. Se não for possível executar essa operação, o driver de miniporto poderá definir Status como um valor de erro apropriado ou não fazer nada.
Requisitos
| Requisito | Valor |
|---|---|
| Cabeçalho | ntddvdeo.h |