IDXGIOutput6::GetDesc1, méthode (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 retournée

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é en tant que 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 clone/dupliqué, ou si l’EDID contient des données manquantes ou non valides. Dans ce cas, le système d’exploitation fournit certaines valeurs par défaut qui correspondent à un affichage SDR standard.

Les caractéristiques de couleur et de luminance signalées d’une sortie peuvent s’ajuster dynamiquement pendant que le système s’exécute en raison d’une action de l’utilisateur ou d’une 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, ré-interrogez 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 surveillance, consultez Utilisation de DirectX avec des affichages à plage dynamique élevée et Couleur avancée.

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

Spécifications

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

Voir aussi

DXGI Interfaces

IDXGIOutput6