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 exibição é enviado para outro, possivelmente um tipo diferente de dispositivo de exibição. 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 miniporto. Normalmente, esse IOCTL é enviado após IOCTL_VIDEO_VALIDATE_CHILD_STATE_CONFIGURATION indica que o driver de miniporto está pronto para fazer a opção. Se o driver de miniporto for capaz de alternar dispositivos de exibição, ele deverá fazer isso e definir o Status membro do StatusBlock para 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 Status membro do StatusBlock para um valor de erro apropriado (descrito na seção statusBlock do), optando por não lidar com a solicitação. Embora essa solicitação seja opcional, é altamente recomendável que o driver de miniporte lide com essa solicitação. A falha ao 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 miniporto define o membro status como NO_ERROR se ele for capaz de executar o comutador de dispositivo de exibição. Se não for capaz de 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 |