struttura DXGK_COLORIMETRY (d3dkmddi.h)

Descrive i colorimetria e i campi strettamente correlati usati per descrivere gli override dal descrittore recuperato dal dispositivo di visualizzazione.

Sintassi

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;

Members

RedPoint

Eseguire l'override per visualizzare il punto rosso. Si noti che ogni dimensione è un valore a 10 bit archiviato nei bit meno significativi. Zero indica che non viene eseguito alcun override.

GreenPoint

Eseguire l'override per visualizzare il punto verde. Si noti che ogni dimensione è un valore a 10 bit archiviato nei bit meno significativi.

BluePoint

Eseguire l'override per il punto blu di visualizzazione. Si noti che ogni dimensione è un valore a 10 bit archiviato nei bit meno significativi.

WhitePoint

Eseguire l'override per visualizzare il punto bianco. Si noti che ogni dimensione è un valore a 10 bit archiviato nei bit meno significativi.

MinLuminance

Eseguire l'override del valore minimo di luminanza supportato dalla visualizzazione misurata in dieci millesimi di nit. Valido solo se MaxLuminance è diverso da zero. Zero è un valore valido.

MaxLuminance

Eseguire l'override del valore massimo di luminanza supportato dalla visualizzazione misurata in dieci millesimi di un nit. Questo livello di dominanza dovrebbe essere supportato solo per un'area relativamente piccola in qualsiasi frame specifico.
Zero indica che non viene eseguito l'override di MaxLuminance, MaxFullFrameLuminance o MinLuminance.

MaxFullFrameLuminance

Eseguire l'override per il valore massimo di luminanza full frame supportato dalla visualizzazione misurata in dieci millesimi di un nit. Questo livello di dominanza deve essere supportato in ogni pixel del fotogramma contemporaneamente per fornire una stima del valore di dominanza media che può essere supportato dallo schermo in un frame. Valido solo se MaxLuminance è diverso da zero. Zero non è un override valido.

FormatBitDepths

Esegue l'override dei bit supportati per canale colore in ognuna delle cinque codifiche dei colori specificate per i formati di collegamento. È necessario impostare almeno un bit, escluso il campo Preferenza riservato e deve essere zero.

StandardColorimetryFlags

Indica il supporto per funzionalità colorimetria e EOTF specifiche tramite campi di bit.

Commenti

Questo struct viene usato sia per l'esecuzione di query sugli override dal driver che per il sistema operativo che segnalano il set finale di valori selezionato. Le sostituzioni sono supportate per le visualizzazioni integrate usando questa struttura incorporata all'interno dello struct DXGK_QUERYINTEGRATEDDISPLAYOUT e per le visualizzazioni esterne in cui questo struct viene usato come buffer di output per un tipo di query dell'adattatore DXGKQAITYPE_QUERYCOLORIMETRYOVERRIDES. Le sostituzioni selezionate e modificate vengono segnalate al driver usando DxgkDdiSetTargetAdjustedColorimetry.

Quando si eseguono query su override, il sistema operativo richiede che tutti i campi vengano compilati dal driver o che il buffer venga lasciato zero per evitare la complessità del tentativo di unire questi attributi correlati da origini diverse. Se lo struct non è completamente zero, il sistema operativo convalida che i campi che non devono essere zero come indicato in precedenza, non sono zero.

I punti di colore vengono ulteriormente convalidati oltre un semplice controllo di integrità (ogni valore deve essere compreso tra 1 e 1023) per garantire valori ragionevoli confrontando le coordinate di ogni punto ai punti standard e assicurando che nessuno sia troppo lontano dallo standard.

Quando il sistema operativo chiama DxgkDdiSetTargetAdjustedColorimetry, formatBitDepths e StandardColorimetryFlags sono zero perché si tratta di campi di funzionalità validi solo nelle query.

Requisiti