IDXGISwapChain4 ::SetHDRMetaData, méthode (dxgi1_5.h)
Avertissement
Il n’est plus recommandé aux applications de définir explicitement des métadonnées HDR sur leur chaîne d’échange à l’aide de SetHDRMetaData. Windows ne garantit pas que les métadonnées de chaîne d’échange sont envoyées au moniteur, et les moniteurs ne gèrent pas les métadonnées HDR de manière cohérente. Par conséquent, il est recommandé aux applications de toujours mapper le contenu dans la plage signalée par le moniteur. Pour plus d’informations sur l’écriture d’applications qui réagissent dynamiquement aux fonctionnalités de surveillance, consultez Utilisation de DirectX avec des affichages à plage dynamique élevée et Couleur avancée.
Pour plus d’informations, consultez Remarques.
Cette méthode définit les métadonnées d’en-tête HDR (High Dynamic Range) et Wide Color Gamut (WCG).
Syntaxe
HRESULT SetHDRMetaData(
[in] DXGI_HDR_METADATA_TYPE Type,
[in] UINT Size,
[in, optional] void *pMetaData
);
Paramètres
[in] Type
Type : DXGI_HDR_METADATA_TYPE
Spécifie un membre de l’énumération DXGI_HDR_METADATA_TYPE .
[in] Size
Type : UINT
Spécifie la taille de pMetaData, en octets.
[in, optional] pMetaData
Type : void*
Spécifie un pointeur void qui référence les métadonnées, le cas échéant. Reportez-vous à la structure DXGI_HDR_METADATA_HDR10 .
Valeur retournée
Type : HRESULT
Cette méthode retourne un code de réussite ou d’erreur HRESULT.
Remarques
Cette méthode définit les métadonnées pour permettre l’ajustement de la sortie d’un moniteur en fonction de ses fonctionnalités. Toutefois, cela ne change pas la façon dont les valeurs de pixels sont interprétées par Windows ou les moniteurs. Pour ajuster l’espace de couleurs de la chaîne d’échange, utilisez Plutôt SetColorSpace1 .
Les applications ne doivent pas s’appuyer sur les métadonnées envoyées au moniteur, car les métadonnées peuvent être ignorées. Les moniteurs ne traitent pas systématiquement les métadonnées HDR, ce qui entraîne une apparence variée de votre contenu sur différents moniteurs. Pour garantir une sortie plus cohérente sur une plage de moniteurs, d’appareils et de cas d’usage, il est recommandé de ne pas utiliser SetHDRMetaData et de mapper le contenu dans la plage de gamut et de luminance prise en charge par le moniteur. Consultez IDXGIOutput6 ::GetDesc1 pour récupérer la plage de gamut et de luminance prises en charge du moniteur. Les moniteurs qui adhèrent à la norme VESA DisplayHDR effectuent automatiquement une forme de découpage pour le contenu en dehors de la plage de gamut et de luminance prises en charge par le moniteur.
Pour plus d’informations sur l’écriture d’applications qui réagissent dynamiquement aux fonctionnalités de surveillance, consultez Utilisation de DirectX avec des affichages à plage dynamique élevée et Couleur avancée.
Configuration requise
| Plateforme cible | Windows |
| En-tête | dxgi1_5.h |
| Bibliothèque | Dxgi1_5.lib |
| DLL | Dxgi1_5.dll |