estrutura DXGK_COLORIMETRY (d3dkmddi.h)

Descreve a colorimetria e os campos intimamente relacionados usados para descrever 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 para o 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

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

BluePoint

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

WhitePoint

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

MinLuminance

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

MaxLuminance

Substitua pelo 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

Substituição para o valor máximo de luminância de quadro completo compatível com a 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 compatível com a exibição em um quadro. Válido somente se MaxLuminance for diferente de zero. Zero não é uma substituição válida.

FormatBitDepths

Substitui os bits com suporte por canal de cor em cada uma das cinco codificações de cores especificadas para formatos de transmissão. 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.

Comentários

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. As substituições têm suporte 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 de 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 zerado para evitar a complexidade de tentar mesclar esses atributos inter-relacionados de fontes diferentes. Se o struct não for 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 sanidade simples marcar (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, 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