estructura DXGK_COLORIMETRY (d3dkmddi.h)

Describe la colorimetría y los campos estrechamente relacionados que se usan para describir las invalidaciones del descriptor recuperado del dispositivo de visualización.

Sintaxis

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;

Miembros

RedPoint

Invalide el punto rojo para mostrar. Tenga en cuenta que cada dimensión es un valor de 10 bits almacenado en los bits menos significativos. Cero indica que no hay invalidación.

GreenPoint

Invalidación para el punto verde para mostrar. Tenga en cuenta que cada dimensión es un valor de 10 bits almacenado en los bits menos significativos.

BluePoint

Invalidación para el punto azul para mostrar. Tenga en cuenta que cada dimensión es un valor de 10 bits almacenado en los bits menos significativos.

WhitePoint

Invalidación para el punto blanco para mostrar. Tenga en cuenta que cada dimensión es un valor de 10 bits almacenado en los bits menos significativos.

MinLuminance

Invalidación del valor de luminancia mínimo admitido por la pantalla medida en un diez milésimas de una nit. Solo es válido si MaxLuminance no es cero. Cero es un valor válido.

MaxLuminance

Invalidación del valor de luminancia máximo admitido por la pantalla medida en un diez milésimas de una nit. Se espera que este nivel de luminancia se admita solo para un área relativamente pequeña en cualquier marco determinado.
Cero indica que no se invalida MaxLuminance, MaxFullFrameLuminance ni MinLuminance.

MaxFullFrameLuminance

Invalidación del valor máximo de luminancia de fotograma completo admitido por la pantalla medida en un diez milésimas de una nit. Este nivel de luminancia debe admitirse en todos los píxeles del fotograma simultáneamente para proporcionar una estimación del valor de luminancia promedio que puede ser compatible con la pantalla a través de un marco. Solo es válido si MaxLuminance no es cero. Cero no es una invalidación válida.

FormatBitDepths

Invalida los bits admitidos por canal de color en cada una de las cinco codificaciones de color especificadas para los formatos de conexión. Se debe establecer al menos un bit, excepto el campo Preferencia que está reservado y debe ser cero.

StandardColorimetryFlags

Indica la compatibilidad con funcionalidades específicas de colorimetry y EOTF mediante campos de bits.

Observaciones

Esta estructura se usa tanto para consultar invalidaciones del controlador como para que el sistema operativo informe del conjunto final de valores que ha seleccionado. Las invalidaciones se admiten para pantallas integradas que usan esta estructura que está incrustada en la estructura de DXGK_QUERYINTEGRATEDDISPLAYOUT y para pantallas externas en las que se usa este struct como búfer de salida es para un tipo de consulta de adaptador DXGKQAITYPE_QUERYCOLORIMETRYOVERRIDES. Las invalidaciones seleccionadas y ajustadas se notifican de nuevo al controlador mediante DxgkDdiSetTargetAdjustedColorimetry.

Al consultar invalidaciones, el sistema operativo requiere que el controlador rellene todos los campos o que el búfer deje ceros para evitar la complejidad de intentar combinar estos atributos relacionados entre orígenes. Si la estructura no está completamente cero, el sistema operativo valida que los campos que no deben ser cero, como se indicó anteriormente, no son cero.

Los puntos de color se validan más allá de una comprobación de integridad simple (cada valor debe estar comprendido entre 1 y 1023) para garantizar valores razonables comparando las coordenadas de cada punto con los puntos estándar y asegurándose de que ninguno está demasiado lejos del estándar.

Cuando el sistema operativo llama a DxgkDdiSetTargetAdjustedColorimetry, formatBitDepths y StandardColorimetryFlags se reducen a cero, ya que son campos de funcionalidad, por lo que solo son válidos en las consultas.

Requisitos

Requisito	Valor
encabezado de	d3dkmddi.h