estrutura DXGK_COLORIMETRY (d3dkmddi.h)

Descreve a colorimetria e os campos intimamente relacionados usados para descrever as substituições do descritor recuperado do dispositivo de exibição.

Sintaxe

typedef struct _DXGK_COLORIMETRY {
  D3DKMDT_2DOFFSET                   RedPoint;
  D3DKMDT_2DOFFSET                   GreenPoint;
  D3DKMDT_2DOFFSET                   BluePoint;
  D3DKMDT_2DOFFSET                   WhitePoint;
  ULONG                              MinLuminance;
  ULONG                              MaxLuminance;
  ULONG                              MaxFullFrameLuminance;
  D3DKMDT_WIRE_FORMAT_AND_PREFERENCE FormatBitDepths;
  DXGK_STANDARD_COLORIMETRY_FLAGS    StandardColorimetryFlags;
} DXGK_COLORIMETRY, *PDXGK_COLORIMETRY;

Membros

RedPoint

Substituição do ponto vermelho de exibição. Observe que cada dimensão é um valor de 10 bits armazenado nos bits menos significativos. Zero indica nenhuma substituição.

GreenPoint

Substitua o ponto verde de exibição. Observe que cada dimensão é um valor de 10 bits armazenado nos bits menos significativos.

BluePoint

Substituir o ponto azul de exibição. Observe que cada dimensão é um valor de 10 bits armazenado nos bits menos significativos.

WhitePoint

Substitua o ponto branco de exibição. Observe que cada dimensão é um valor de 10 bits armazenado nos bits menos significativos.

MinLuminance

Substitua o valor mínimo de luminância suportado pela exibição medida em um décimo milésimo de nit. Válido somente se MaxLuminance não for zero. Zero é um valor válido.

MaxLuminance

Substitua o valor máximo de luminância suportado pela exibição medida em um décimo milésimo de nit. Espera-se que esse nível de luminância tenha suporte apenas para uma área relativamente pequena em qualquer quadro específico.
Zero indica nenhuma substituição de MaxLuminance, MaxFullFrameLuminance ou MinLuminance.

MaxFullFrameLuminance

Substitua o valor máximo de luminância de quadro completo suportado pela exibição medida em um décimo milésimo de nit. Esse nível de luminância deve ter suporte em cada pixel no quadro simultaneamente para fornecer uma estimativa do valor médio de luminância que pode ser suportado pela exibição em um quadro. Válido somente se MaxLuminance não for zero. Zero não é uma substituição válida.

FormatBitDepths

Substitui os bits com suporte por canal de cores em cada uma das cinco codificações de cores especificadas para formatos de fio. Pelo menos um bit deve ser definido, excluindo o campo Preferência que é reservado e deve ser zero.

StandardColorimetryFlags

Indica suporte para recursos específicos de colorimetria e EOTF usando campos de bits.

Observações

Esse struct é usado tanto para consultar substituições do driver quanto para o sistema operacional que relata o conjunto final de valores que ele selecionou. Há suporte para substituições para exibições integradas usando essa estrutura que é inserida no struct DXGK_QUERYINTEGRATEDDISPLAYOUT e para exibições externas em que esse struct é usado como o buffer de saída é para um tipo de consulta do adaptador DXGKQAITYPE_QUERYCOLORIMETRYOVERRIDES. As substituições selecionadas e ajustadas são relatadas de volta ao driver usando DxgkDdiSetTargetAdjustedColorimetry.

Ao consultar substituições, o sistema operacional requer que todos os campos sejam preenchidos pelo driver ou o buffer seja deixado zerado para evitar a complexidade de tentar mesclar esses atributos inter relacionados de diferentes fontes. Se o struct não estiver completamente zerado, o sistema operacional validará que os campos que não devem ser zero, conforme observado acima, não serão zero.

Os pontos de cor são validados além de uma verificação de sanidade simples (cada valor deve estar entre 1 e 1023) para garantir valores razoáveis comparando as coordenadas de cada ponto com os pontos padrão e garantindo que nenhum esteja muito longe do padrão.

Quando o sistema operacional chama DxgkDdiSetTargetAdjustedColorimetry, os FormatBitDepths e StandardColorimetryFlags são zerados, pois são campos de funcionalidade, portanto, válidos apenas em consultas.

Requisitos

Requisito	Valor
cabeçalho	d3dkmddi.h