Metodo IDXGISwapChain4::SetHDRMetaData (dxgi1_5.h)
Avviso
Non è più consigliabile per le app impostare in modo esplicito i metadati HDR nella catena di scambio usando SetHDRMetaData. Windows non garantisce che i metadati della catena di scambio vengano inviati al monitor e i monitor non gestiscono in modo coerente i metadati HDR. È quindi consigliabile che le app inseriscano sempre il contenuto della mappa tono nell'intervallo segnalato dal monitoraggio. Per altre informazioni su come scrivere app che reagiscono in modo dinamico per monitorare le funzionalità, vedere Uso di DirectX con schermi a intervalli dinamici elevati e Colore avanzato.
Per altri dettagli, vedere La sezione Osservazioni.
Questo metodo imposta i metadati dell'intestazione HDR (High Dynamic Range) e Wide Color Gamut (WCG).
Sintassi
HRESULT SetHDRMetaData(
[in] DXGI_HDR_METADATA_TYPE Type,
[in] UINT Size,
[in, optional] void *pMetaData
);
Parametri
[in] Type
Tipo: DXGI_HDR_METADATA_TYPE
Specifica un membro dell'enumerazione DXGI_HDR_METADATA_TYPE .
[in] Size
Tipo: UINT
Specifica le dimensioni di pMetaData, in byte.
[in, optional] pMetaData
Tipo: void*
Specifica un puntatore void che fa riferimento ai metadati, se esistente. Fare riferimento alla struttura DXGI_HDR_METADATA_HDR10 .
Valore restituito
Tipo: HRESULT
Questo metodo restituisce un codice HRESULT riuscito o di errore.
Commenti
Questo metodo imposta i metadati per consentire la regolazione dell'output di un monitoraggio in base alle relative funzionalità. Tuttavia, non cambia il modo in cui i valori pixel vengono interpretati da Windows o monitor. Per regolare lo spazio colore della catena di scambio, usare invece SetColorSpace1 .
Le applicazioni non devono basarsi sui metadati inviati al monitoraggio perché i metadati possono essere ignorati. I monitor non elaborano in modo coerente i metadati HDR, generando un aspetto diverso del contenuto su monitor diversi. Per garantire un output più coerente in una gamma di monitor, dispositivi e casi d'uso, è consigliabile non usare SetHDRMetaData e per invece il contenuto della mappa tono nell'intervallo di gamut e luminanza supportato dal monitoraggio. Vedere IDXGIOutput6::GetDesc1 per recuperare l'intervallo di luminanza e la gamma di luminanza supportati dal monitoraggio. I monitoraggi aderendo allo standard VESA DisplayHDR eseguono automaticamente una forma di ritaglio per il contenuto all'esterno dell'intervallo di gamut e luminanza supportato dal monitor.
Per altre informazioni su come scrivere app che reagiscono in modo dinamico per monitorare le funzionalità, vedere Uso di DirectX con schermi a intervalli dinamici elevati e Colore avanzato.
Requisiti
| Piattaforma di destinazione | Windows |
| Intestazione | dxgi1_5.h |
| Libreria | Dxgi1_5.lib |
| DLL | Dxgi1_5.dll |