DXGK_DIAGNOSTIC_PSR estrutura (dispmprt.h)

Um diagnóstico que indica que o painel conectado por meio do destino no campo TargetId na estrutura DXGK_DIAGNOSTIC_HEADER entrou ou saiu de um estado de PSR (auto-atualização) do painel.

Sintaxe

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

Membros

Header

Uma estrutura DXGK_DIAGNOSTIC_HEADER que indica que tipo de diagnóstico está sendo relatado.

RefreshReason

Um conjunto de campos de bits DXGK_DIAGNOSTIC_PSR_REFRESH_REASON que indicam o motivo ou os motivos para sair do PSR ou, se nenhum estiver definido, indica que o destino está inserindo PSR.

Value

Valor do PSR.

Observações

Quando o painel entra em auto-atualização, o driver deve enviar esse diagnóstico sem nenhum dos campos de bit definidos no campo RefreshReason.

Quando o painel precisar sair da auto-atualização para atualizar o conteúdo, o driver deverá enviar esse diagnóstico com pelo menos um dos campos de bit dentro de RefreshReason, indicando os motivos para sair do PSR. Se vários fatores causaram a saída do PSR, o driver deverá tentar definir todos os motivos apropriados do campo de bits. No entanto, é mais importante que os sinalizadores não sejam definidos se o motivo não foi o gatilho para sair do PSR, do que capturar todos os motivos que dispararam a saída. Isso ocorre porque, depois que a PSR for encerrada, o driver não deverá relatar posteriormente motivos adicionais de que a PSR teria sido encerrada, portanto, em relatórios é válido, desde que pelo menos um motivo seja fornecido.

Se o painel e o driver derem suporte ao PSR2, em que as atualizações não exigem que um quadro completo seja enviado ao painel para atualizar uma parte menor, essas atualizações ainda deverão ser relatadas ao sistema operacional ao sair do PSR. Por exemplo, se a exibição estiver em PSR e a forma do cursor for alterada sem nenhuma outra atualização, o driver deverá ser capaz de enviar uma pequena fração do quadro completo de pixels, provavelmente apenas as linhas que contêm o cursor. Nesse caso, o driver ainda deve informar que a PSR foi encerrada, com razão CursorUpdate. Em uma versão posterior, campos de diagnóstico extras podem ser adicionados para distinguir atualizações parciais e completas.

Requisitos

Requisito	Valor
cabeçalho	dispmprt.h