IOCTL_VIDEO_SET_CHILD_STATE_CONFIGURATION IOCTL (ntddvdeo.h)

  • Artigo

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

IRP_MJ_DEVICE_CONTROL

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

Confira também

IOCTL_VIDEO_GET_CHILD_STATE

IOCTL_VIDEO_VALIDATE_CHILD_STATE_CONFIGURATION

VIDEO_CHILD_STATE_CONFIGURATION