DXGKDDI_SETTARGETADJUSTEDCOLORIMETRY funzione di callback (dispmprt.h)

Segnala i valori di colorimetria selezionati dal sistema operativo per una destinazione.

Sintassi

DXGKDDI_SETTARGETADJUSTEDCOLORIMETRY DxgkddiSettargetadjustedcolorimetry;

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

Parametri

[in] hAdapter

[in] Identifica l'adattatore.

[in] TargetId

[in] Identificatore della destinazione del video di una scheda di visualizzazione.

[in] AdjustedColorimetry

[in] Struttura DXGK_COLORIMETRY contenente i campi correlati ai colorimetria per il monitoraggio collegato a questa destinazione dopo che il sistema operativo ha elaborato il descrittore del dispositivo di visualizzazione, tutte le sostituzioni e le eventuali modifiche.

Valore restituito

Il driver restituisce STATUS_SUCCESS se ha aggiornato i valori di colorimetria in base ai dati forniti.

Se il driver ha esito negativo, il sistema operativo ripristina i valori SDR standard per tutti i parametri, 709 primaries, gamma 2.2 e 8-nit per ogni componente colore rgb wire format, ma non chiamerà il driver perché questo non dovrebbe mai avere esito negativo. Al contrario, il driver deve aggiornare anche la relativa rappresentazione interna del dispositivo di visualizzazione in modo che sia SDR standard.

Commenti

Poiché i dispositivi di visualizzazione correnti hanno descrizioni incomplete e imprecise dei parametri correlati alla colorimetria, sono necessarie le sostituzioni. Le sostituzioni accettano due forme: override del driver e override del sistema operativo per parametri non validi. Nelle versioni future del sistema operativo è previsto che verranno implementate altre sostituzioni. Per mantenere il driver sincronizzato con i parametri usati dal sistema operativo, il sistema operativo chiamerà DxgkDdiSetTargetAdjustedColorimetry per ogni destinazione.

In genere, questa chiamata verrà eseguita una sola volta dopo che il driver è stato sottoposto a query per le sostituzioni e la convalida del sistema operativo è stata completata, ma prima dell'attivazione della visualizzazione. Quando il sistema operativo ha altre forme di override, è possibile che arrivino dopo che lo schermo è già attivo. In questo caso, il sistema operativo aggiornerà comunque il driver che dovrebbe apportare eventuali aggiornamenti necessari alla pipeline di visualizzazione all'interno di due fotogrammi. Se necessario, il driver deve recuperare l'output di visualizzazione per applicare la modifica.

Gli oggetti FormatBitDepths e StandardColorimetryFlags nel DXGK_COLORIMETRY sono azzerati perché si tratta di campi di funzionalità, quindi validi solo nelle query.

Questa funzione viene sempre chiamata a livello PASSIVO, quindi il codice di supporto deve essere reso pageable laddove possibile.

Requisiti

Requisito	Valore
Piattaforma di destinazione	Windows
Intestazione	dispmprt.h