Compartilhar via


estrutura DXGK_DIAGNOSTIC_PSR (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 DXGK_DIAGNOSTIC_PSR_REFRESH_REASON campos de bits 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.

Comentários

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

Quando o painel precisa sair da auto-atualização para atualizar o conteúdo, o driver deve enviar esse diagnóstico com pelo menos um dos campos de bits dentro de RefreshReason, indicando os motivos para sair do PSR. Se vários fatores fizeram com que a PSR fosse encerrada, 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 pelos quais 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 relatar que a PSR foi encerrada, com o motivo CursorUpdate. Em uma versão posterior, campos de diagnóstico adicionais podem ser adicionados para distinguir atualizações parciais e completas.

Requisitos

Requisito Valor
Cabeçalho dispmprt.h