DXGKDDI_SETTARGETADJUSTEDCOLORIMETRY função de retorno de chamada (dispmprt.h)

Relata os valores de colorimetria selecionados pelo sistema operacional para um destino.

Sintaxe

DXGKDDI_SETTARGETADJUSTEDCOLORIMETRY DxgkddiSettargetadjustedcolorimetry;

NTSTATUS DxgkddiSettargetadjustedcolorimetry(
  [in] IN_CONST_HANDLE hAdapter,
  [in] IN D3DDDI_VIDEO_PRESENT_TARGET_ID TargetId,
  [in] IN DXGK_COLORIMETRY AdjustedColorimetry
)
{...}

Parâmetros

[in] hAdapter

[in] Identifica o adaptador.

[in] TargetId

[in] O identificador do destino presente do vídeo de um adaptador de exibição.

[in] AdjustedColorimetry

[in] Uma estrutura DXGK_COLORIMETRY que contém os campos relacionados à colorimetria para o monitor anexado a esse destino depois que o sistema operacional processou o descritor do dispositivo de exibição, todas as substituições e quaisquer ajustes.

Retornar valor

O driver retornará STATUS_SUCCESS se tiver atualizado seus valores de colorimetria com base nos dados fornecidos.

Se o driver falhar, o sistema operacional reverter aos valores de SDR padrão para todos os parâmetros, 709 primárias, 2,2 gama e formato de fio RGB de componente de 8 nits por cor, mas não chamará o driver, pois isso nunca deve falhar. Em vez disso, o driver também deve atualizar sua representação interna do dispositivo de exibição para ser SDR padrão.

Comentários

Como os dispositivos de exibição atuais têm descrições incompletas e imprecisas de seus parâmetros relacionados à colorimetria, as substituições são necessárias. As substituições tomam duas formas: substituições de driver e substituições do sistema operacional para parâmetros inválidos. Em versões futuras do sistema operacional, espera-se que substituições adicionais sejam implementadas. Para manter o driver sincronizado com os parâmetros que o sistema operacional está usando, o sistema operacional chamará DxgkDdiSetTargetAdjustedColorimetry para cada destino.

Normalmente, essa chamada só será feita uma vez depois que o driver tiver sido consultado para substituições e a validação do sistema operacional tiver sido concluída, mas antes que a exibição seja ativada. Quando o sistema operacional tem outras formas de substituições, é possível que eles cheguem depois que a exibição já estiver ativa. Nesse caso, o sistema operacional ainda atualizará o driver que deverá fazer as atualizações necessárias para seu pipeline de exibição dentro de dois quadros. Se necessário, o driver deve alterar a saída de exibição para aplicar a alteração.

Os FormatBitDepths e StandardColorimetryFlags no DXGK_COLORIMETRY são zerados, pois são campos de funcionalidade, portanto, válidos apenas em consultas.

Essa função é sempre chamada no nível PASSIVO, portanto, o código de suporte deve ser disponibilizado sempre que possível.

Requisitos