Méthode IDXGIOutput6::GetDesc1 (dxgi1_6.h)

Obtenez une description étendue de la sortie qui inclut les caractéristiques de couleur et le type de connexion.

Syntaxe

HRESULT GetDesc1(
  [out] DXGI_OUTPUT_DESC1 *pDesc
);

Paramètres

[out] pDesc

Type : DXGI_OUTPUT_DESC1*

Pointeur vers la description de sortie (voir DXGI_OUTPUT_DESC1).

Valeur de retour

Type : HRESULT

Retourne un code qui indique la réussite ou l’échec. S_OK en cas de réussite, DXGI_ERROR_INVALID_CALL si pDesc est passé au format NULL.

Notes

Certains scénarios n’ont pas de valeurs bien définies pour tous les champs de ce struct. Par exemple, si cet IDXGIOutput représente un jeu de clones/doublons, ou si l’EDID contient des données manquantes ou non valides. Dans ce cas, le système d’exploitation fournit des valeurs par défaut qui correspondent à un affichage SDR standard.

Les caractéristiques de couleur et de luminosité signalées d’une sortie peuvent s’ajuster dynamiquement pendant l’exécution du système en raison d’une action de l’utilisateur ou de la modification des conditions ambiantes. Par conséquent, les applications doivent interroger régulièrement IDXGIFactory::IsCurrent et recréer leur IDXGIFactory s’il retourne FALSE. Ensuite, interrogez de nouveau GetDesc1 à partir de la sortie équivalente de la nouvelle fabrique pour récupérer les informations de couleur les plus récentes.

Pour plus d’informations sur l’écriture d’applications qui réagissent dynamiquement aux fonctionnalités de supervision, consultez Utilisation de DirectX avec des affichages à plage dynamique élevée et Couleur avancée.

Sur un bureau à haute résolution, GetDesc1 retourne la taille de l’écran visualisé, sauf si l’application est marquée comme prenant en charge des ppp élevés. Pour plus d’informations sur l’écriture d’applications Win32 prenant en charge les ppp, consultez Haute résolution.

Configuration requise

   
Plateforme cible Windows
En-tête dxgi1_6.h
Bibliothèque DXGI.lib

Voir aussi

DXGI Interfaces

IDXGIOutput6