IDXGIOutput1 ::FindClosestMatchingMode1, méthode (dxgi1_2.h)

Article
03/04/2024

Recherche le mode d’affichage qui correspond le plus au mode d’affichage demandé.

Syntaxe

HRESULT FindClosestMatchingMode1(
  [in]           const DXGI_MODE_DESC1 *pModeToMatch,
  [out]          DXGI_MODE_DESC1       *pClosestMatch,
  [in, optional] IUnknown              *pConcernedDevice
);

Paramètres

[in] pModeToMatch

Pointeur vers la structure DXGI_MODE_DESC1 qui décrit le mode d’affichage à mettre en correspondance. Les membres de DXGI_MODE_DESC1 ne peuvent pas être spécifiés, ce qui n’indique aucune préférence pour ce membre. La valeur 0 pour Width ou Height indique que la valeur n’est pas spécifiée. Si la largeur ou la hauteur est égale à 0, les deux doivent être égales à 0. Un numérateur et un dénominateur de 0 dans RefreshRate indiquent qu’il n’est pas spécifié. Les autres membres de DXGI_MODE_DESC1 ont des valeurs d’énumération qui indiquent que le membre n’est pas spécifié. Si pConcernedDevice a la valeur NULL, le membre Format de DXGI_MODE_DESC1 ne peut pas être DXGI_FORMAT_UNKNOWN.

[out] pClosestMatch

Pointeur vers la structure DXGI_MODE_DESC1 qui reçoit une description du mode d’affichage qui correspond le plus au mode d’affichage décrit dans pModeToMatch.

[in, optional] pConcernedDevice

Pointeur vers l’interface de périphérique Direct3D. Si ce paramètre a la valeur NULL, FindClosestMatchingMode1 retourne uniquement les modes dont le format correspond à celui de pModeToMatch ; Sinon, FindClosestMatchingMode1 retourne uniquement les formats pris en charge pour l’analyse par l’appareil. Pour plus d’informations sur les formats pris en charge pour l’analyse par l’appareil à chaque niveau de fonctionnalité :

Valeur retournée

Retourne l’un des codes d’erreur décrits dans la rubrique DXGI_ERROR .

Remarques

Les appareils Direct3D nécessitent des formats UNORM.

FindClosestMatchingMode1 recherche le mode d’affichage disponible le plus proche du mode que vous spécifiez dans pModeToMatch.

Si vous définissez le membre Stereo dans la structure DXGI_MODE_DESC1 vers laquelle pModeToMatch pointe pour spécifier un mode stéréo en tant qu’entrée, FindClosestMatchingMode1 considère uniquement les modes stéréo. FindClosestMatchingMode1 considère uniquement les modes mono si Stéréo n’est pas défini.

FindClosestMatchingMode1 résout les membres de même classement des modes d’affichage (c’est-à-dire tous spécifiés ou tous non spécifiés, et ainsi de suite) dans l’ordre suivant :

ScanlineOrdering
Mise à l'échelle
Format
Résolution :
RefreshRate

Lorsque FindClosestMatchingMode1 détermine la valeur la plus proche pour un membre particulier, il utilise les membres précédemment mis en correspondance pour filtrer les choix de liste en mode d’affichage et ignore les autres membres. Par exemple, lorsque FindClosestMatchingMode1 correspond à la résolution, il a déjà filtré la liste des modes d’affichage par un certain ScanlineOrdering, Scaling et Format, tandis qu’il ignore RefreshRate. Ce classement ne définit pas l’ordre absolu pour chaque scénario d’utilisation de FindClosestMatchingMode1, car l’application peut choisir certaines valeurs initialement, ce qui modifie efficacement l’ordre de résolution des membres.

FindClosestMatchingMode1 correspond aux membres du mode d’affichage un à la fois, généralement dans un ordre spécifié.

Si un membre n’est pas spécifié, FindClosestMatchingMode1 gravite vers les valeurs du bureau associées à cette sortie. Si cette sortie ne fait pas partie du bureau, FindClosestMatchingMode1 utilise la sortie de bureau par défaut pour rechercher des valeurs. Si une application utilise un mode d’affichage entièrement non spécifié, FindClosestMatchingMode1 retourne généralement un mode d’affichage qui correspond aux paramètres du bureau pour cette sortie.
Étant donné que les membres non spécifiés ont une priorité inférieure à celle des membres spécifiés, FindClosestMatchingMode1 résout les membres non spécifiés plus tard que les membres spécifiés.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 8 et mise à jour de plateforme pour Windows 7 [applications de bureau \| Applications UWP]
Serveur minimal pris en charge	Windows Server 2012 et mise à jour de plateforme pour Windows Server 2008 R2 [applications de bureau \| Applications UWP]
Plateforme cible	Windows
En-tête	dxgi1_2.h
Bibliothèque	DXGI.lib

Voir aussi

IDXGIOutput1

Partager via