Partager via

IDXGISwapChain4 ::SetHDRMetaData, méthode (dxgi1_5.h)

  • Article

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

Voir aussi

Améliorations apportées à DXGI 1.5

IDXGISwapChain4