estructura DXGK_DSI_TRANSMISSION (dispmprt.h)

Artículo
08/07/2023

La estructura DXGK_DSI_TRANSMISSION se usa para transmitir paquetes de interfaz serie de visualización (DSI) al controlador de bus (kernel de gráficos).

Sintaxis

typedef struct _DXGK_DSI_TRANSMISSION {
  UINT            TotalBufferSize;
  BYTE            PacketCount;
  BYTE            FailedPacket;
  struct {
    WORD TransmissionMode : 2;
    WORD ReportMipiErrors : 1;
    WORD ClearMipiErrors : 1;
    WORD SecondaryPort : 1;
    WORD ManufacturingMode : 1;
    WORD Reserved : 10;
  };
  WORD            ReadWordCount;
  WORD            FinalCommandExtraPayload;
  WORD            MipiErrors;
  WORD            HostErrors;
  DXGK_DSI_PACKET Packets[1];
} DXGK_DSI_TRANSMISSION, *PDXGK_DSI_TRANSMISSION;

Miembros

TotalBufferSize

Número de bytes de toda la estructura, incluidos el encabezado, los comandos y la carga.

PacketCount

Número de elementos DXGK_DSI_PACKET de la matriz Packets .

FailedPacket

Índice, cuando se conoce, de DXGK_DSI_PACKET en la matriz Packets que tenía un error. Si no se conoce o no se detecta ningún error de paquete, se establece el valor DXGK_DSI_INVALID_PACKET_INDEX.

TransmissionMode

Uno de los valores de DXGK_MIPI_CONTROL_TRANSMISSIONMODE.

ReportMipiErrors

Si se establece, el controlador de gráficos debe solicitar errores MIPI acumulados en la confirmación del comando final y notificarlos en el campo MipiErrors.

ClearMipiErrors

Si set y el controlador de gráficos han enviado comandos iniciados por el panel que no son OEM, el controlador debe asegurarse de que se borran los errores MIPI acumulados antes de empezar a enviar esta secuencia.

SecondaryPort

Establezca si la transmisión debe enviarse a un panel secundario, no a la principal.

ManufacturingMode

Se establece para desactivar la validación del sistema operativo de los comandos DCS cuando el sistema está en modo de fabricación.

Reserved

Reservado.

ReadWordCount

FinalCommandExtraPayload

MipiErrors

Combinación de los siguientes valores de error posibles, que indican los errores notificados por la comunicación con el periférico.

DXGK_MIPI_DSI_XXX Error	Significado
DXGK_MIPI_DSI_SOT_ERROR	Posible error en Inicio de High-Speed secuencia de guía de transmisión
DXGK_MIPI_DSI_SOT_SYNC_ERROR	Error en inicio de High-Speed secuencia de guía de transmisión
DXGK_MIPI_DSI_EOT_SYNC_ERROR	Periférico detectó bytes incompletos en High-Speed transmisión
DXGK_MIPI_DSI_ESCAPE_MODE_ENTRY_COMMAND_ERROR	Error o periférico no reconoce la secuencia de escape
DXGK_MIPI_DSI_LOW_POWER_TRANSMIT_SYNC_ERROR	Periférico detectó bytes incompletos en Low-Speed transmisión
DXGK_MIPI_DSI_FALSE_CONTROL_ERROR	Error detectado de periféricos en secuencia de escape o secuencia de solución alternativa
DXGK_MIPI_DSI_CONTENTION_DETECTED	Contención detectada
DXGK_MIPI_DSI_CHECKSUM_ERROR_CORRECTED	Se detectó y corrigió un error de suma de comprobación.
DXGK_MIPI_DSI_CHECKSUM_ERROR_NOT_CORRECTED	Se detectó un error de suma de comprobación, pero no se pudo corregir.
DXGK_MIPI_DSI_LONG_PACKET_PAYLOAD_CHECKSUM_ERROR	La suma de comprobación de carga era incorrecta para un paquete largo
DXGK_MIPI_DSI_DSI_DATA_TYPE_NOT_RECOGNIZED	Periférico no reconoce el tipo de datos enviado a él
DXGK_MIPI_DSI_DSI_VC_ID_INVALID	Periférico se envió un comando para un canal virtual que no admite
DXGK_MIPI_DSI_INVALID_TRANSMISSION_LENGTH	Periférico detectó que el número de bytes transmitidos no coincide con lo especificado en el encabezado.
DXGK_MIPI_DSI_DSI_PROTOCOL_VIOLATION	Periférico detectado la falta de EoTP en una transmisión o host no pudo señalar el giro del bus para una lectura

HostErrors

Combinación de DXGK_HOST_DSI_XXX errores que indican los errores notificados por el controlador de gráficos o el sistema operativo.

DXGK_HOST_DSI_XXX Error	Significado
DXGK_HOST_DSI_DEVICE_NOT_READY	El host detectó que se realizó una solicitud para un dispositivo que no está en el estado correcto para poder recibir la solicitud.
DXGK_HOST_DSI_INTERFACE_RESET	El controlador de gráficos detectó un error que requería un restablecimiento de la interfaz DSI con el panel. El controlador del panel debe comprobar el estado del dispositivo antes de reanudar las transmisiones normales.
DXGK_HOST_DSI_DEVICE_RESET	El controlador de gráficos detectó un error que requería un restablecimiento del panel y se debería suponer que se ha perdido el estado. El controlador del panel debe volver a aplicar cualquier estado de dispositivo privado antes de reanudar las transmisiones normales.
DXGK_HOST_DSI_TRANSMISSION_CANCELLED	El host canceló la transmisión, que estaba en curso, porque el bus era necesario para transmisiones de mayor prioridad, como la actualización de píxeles. El controlador del panel debe asegurarse de que cualquier efecto que pudiera haber tenido una transmisión parcial se deshaga o compruebe antes de continuar con las transmisiones. Si este error se produce con frecuencia, puede significar que la transmisión es demasiado grande para completarse de forma confiable y el controlador del panel debe cambiarse para dividirlo en varias transmisiones.
DXGK_HOST_DSI_TRANSMISSION_DROPPED	El host quitó la transmisión antes de iniciarla porque las transmisiones de mayor prioridad provocaron que la transmisión se retrasara más allá del límite permitido. El controlador del panel puede volver a intentar la misma transmisión, si sigue siendo relevante. Este error indica que el ancho de banda del vínculo DSI no es adecuado, por lo que no debe producirse en un entorno comercial. Si la transmisión es suficientemente grande, esto puede indicar que la transmisión debe dividirse con el fin de tener éxito de forma confiable.
DXGK_HOST_DSI_TRANSMISSION_TIMEOUT	El host detectó un tiempo de espera de hardware al comunicarse con el periférico. El controlador del panel debe asegurarse de que cualquier efecto que pudiera haber tenido una transmisión parcial se deshaga o compruebe antes de continuar con las transmisiones. A menos que la transmisión esté causando que el panel entre en un estado incorrecto, no hay mitigación para esto en el controlador del panel, por lo que debe retroceder e intentar reanudarse.
DXGK_HOST_DSI_INVALID_TRANSMISSION	La validación del sistema operativo del búfer de DXGK_DSI_TRANSMISSION encontró errores para que la transmisión se cancelara sin llamar al controlador de gráficos ni comprobar si hay paquetes prohibidos. Esto se debe a un error en el controlador del panel OEM o a la validación del sistema operativo. El `FailedPacket` campo indica el primer paquete incorrecto si el error es específico de un paquete.
DXGK_HOST_DSI_OS_REJECTED_PACKET	El sistema operativo encontró paquetes que están prohibidos para que la transmisión se cancelara sin llamar al controlador de gráficos. El `FailedPacket` campo indica el primer paquete incorrecto.
DXGK_HOST_DSI_DRIVER_REJECTED_PACKET	El controlador de gráficos encontró paquetes que no se pueden procesar de forma segura, por lo que la transmisión se canceló sin ninguna interacción periférica. El `FailedPacket` campo indica el primer paquete incorrecto.
DXGK_HOST_DSI_BAD_TRANSMISSION_MODE	El controlador de gráficos no pudo usar el DXGK_DSI_CONTROL_TRANSMISSION_MODE especificado. El `FailedPacket` campo indica el primer paquete incompatible con el modo de transmisión.