IOCTL_MIPI_DSI_RESET IOCTL (ntddvdeo.h)
IOCTL_MIPI_DSI_RESET solicita a redefinição de um dispositivo no driver gráfico e no controle do sistema operacional.
Código principal
Buffer de entrada
n/d
Comprimento do buffer de entrada
n/d
Buffer de saída
n/d
Comprimento do buffer de saída
n/d
Buffer de entrada/saída
Uma estrutura DXGK_DSI_RESET .
Comprimento do buffer de entrada/saída
Pelo menos o sizeof(DXGK_DSI_RESET)
Bloco de status
Irp-IoStatus.Status será definido como STATUS_SUCCESS se a solicitação for bem-sucedida>. Caso contrário, Status para a condição de erro apropriada como um código NTSTATUS.
Para obter mais informações, consulte Valores NTSTATUS.
Comentários
As IOCTLs da INTERFACE serial digital (DSI) da MIPI (Mobile Industry Processor Interface) devem ser manipuladas pelo driver monitor, painel oem ou porta/miniport.
Se um driver de painel OEM detectar que o painel está em um estado inválido, ele deverá enviar IOCTL_MIPI_DSI_RESET para solicitar uma redefinição do dispositivo em driver gráfico e controle do sistema operacional. O sistema operacional coordenará a redefinição com o driver gráfico. Uma redefinição é uma operação de peso pesado que causará o espaço em branco para vários quadros e, portanto, deve ser usada apenas como último recurso.
A operação normal do painel não pode continuar durante o processamento de uma redefinição, portanto, o sistema operacional tratará de forma semelhante a uma alteração no modo de exibição, liberando a atividade de GPU pendente, incluindo quaisquer inversões e bloqueando o novo trabalho até a conclusão. O sistema operacional converte o IOCTL em uma chamada DDI DsiReset . O driver deve remover completamente a energia do painel e reinicializá-la do zero e, após o atraso apropriado, executar todas as ações necessárias para restaurar o painel para um estado viável antes de retornar. Quando definido, o sinalizador SecondaryPort indica que a redefinição deve ser direcionada para um painel secundário em vez do primário.
Se o driver gráfico exigir um modo completo definido para executar ou restaurar de uma redefinição de painel, ele deverá definir o sinalizador de saída NeedModeSet. Se definido no retorno da chamada, o sistema operacional responderá com uma chamada DxgkDdiSetTimingsFromVidPn antes de desbloquear a atividade normal. O driver pode optar por adiar parte do trabalho de redefinição para essa chamada, se necessário, desde que um estado viável seja esperado após a chamada de intervalos definidos.
O driver gráfico deve relatar erros mipi de baixo nível detectados e não manipulados pelo driver por meio do campo de saída MipiErrors .
Se ocorrer um erro irrecuperável durante a redefinição, o driver gráfico deverá definir o sinalizador de saída ResetFailed . Espera-se que seja uma falha catastrófica. O driver gráfico também deve sinalizar que nenhuma exibição está disponível no destino indicando que ocorreu um desconectamento usando o retorno de chamada DxgkCbIndicateConnectorChange e, em seguida, respondendo a DxgkDdiQueryConnectionChange relatando um TargetStatusDisconnected para o destino que falhou.
Os campos de saída serão propagados de volta para o buffer de saída do IOCTL.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows 10, versão 2004 |
| Cabeçalho | ntddvdeo.h |