estructura DXGK_DIAGNOSTIC_PSR (dispmprt.h)

Diagnóstico que indica que el panel conectado a través del destino en el campo TargetId de la estructura DXGK_DIAGNOSTIC_HEADER ha entrado o salido de un estado de actualización automática del panel (PSR).

Sintaxis

typedef struct _DXGK_DIAGNOSTIC_PSR {
  DXGK_DIAGNOSTIC_HEADER Header;
  union {
    DXGK_DIAGNOSTIC_PSR_REFRESH_REASON RefreshReason;
    UINT                               Value;
  };
} DXGK_DIAGNOSTIC_PSR;

Miembros

Header

Estructura DXGK_DIAGNOSTIC_HEADER que indica qué tipo de diagnóstico se está notificando.

RefreshReason

Un conjunto de DXGK_DIAGNOSTIC_PSR_REFRESH_REASON campos de bits que indican el motivo o los motivos para salir de PSR o, si no se establece ninguno, indica que el destino está escribiendo PSR.

Value

Valor de PSR.

Comentarios

Cuando el panel entra en la actualización automática, el controlador debe enviar este diagnóstico con ninguno de los campos de bits establecidos en el campo RefreshReason .

Cuando el panel necesite salir de la actualización automática para actualizar el contenido, el controlador debe enviar este diagnóstico con al menos uno de los campos de bits de RefreshReason, lo que indica los motivos para salir de PSR. Si se han salido varios factores de PSR, el controlador debe intentar establecer todas las razones de campo de bits adecuadas. Sin embargo, es más importante que las marcas no se deben establecer si el motivo no era el desencadenador para salir de PSR, de lo que es capturar todas las razones por las que se desencadenó la salida. Esto se debe a que una vez que se ha salido de PSR, el controlador no debe informar posteriormente de motivos adicionales por los que PSR se habría salido, por lo que la notificación es válida, siempre y cuando se proporcione al menos un motivo.

Si el panel y el controlador admiten PSR2, donde las actualizaciones no requieren que se envíe un marco completo al panel con el fin de actualizar una parte más pequeña, estas actualizaciones se seguirán notificando al sistema operativo al salir de PSR. Por ejemplo, si la pantalla está en PSR y la forma del cursor se cambia sin ninguna otra actualización, el controlador debe poder enviar una pequeña fracción del marco completo de píxeles, probablemente solo las líneas que contengan el cursor. En este caso, el controlador debe seguir informando de que se ha salido de PSR, con el motivo CursorUpdate. En una versión posterior, se pueden agregar campos de diagnóstico adicionales para distinguir las actualizaciones parciales y completas.

Requisitos