IDXGIOutput::FindClosestMatchingMode, méthode (dxgi.h)

[À compter de Direct3D 11.1, nous vous recommandons de ne plus utiliser FindClosestMatchingMode pour trouver le mode d’affichage qui correspond le plus au mode d’affichage demandé. Utilisez plutôt IDXGIOutput1::FindClosestMatchingMode1, qui prend en charge le mode d’affichage stéréo.]

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

Syntaxe

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

Paramètres

[in] pModeToMatch

Type : const DXGI_MODE_DESC*

Mode d’affichage souhaité (voir DXGI_MODE_DESC). Les membres de DXGI_MODE_DESC 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 Largeur ou Hauteur ont la valeur 0, les deux doivent être 0. Un numérateur et un dénominateur de 0 dans RefreshRate indiquent qu’il n’est pas spécifié. D’autres membres de DXGI_MODE_DESC ont des valeurs d’énumération indiquant que le membre n’est pas spécifié. Si pConcernedDevice a la valeur NULL, format ne peut pas être DXGI_FORMAT_UNKNOWN.

[out] pClosestMatch

Type : DXGI_MODE_DESC*

Mode qui correspond le plus étroitement à pModeToMatch.

[in, optional] pConcernedDevice

Type : IUnknown*

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

• Prise en charge du format DXGI pour le matériel de niveau de fonctionnalité Direct3D 12.1
• Prise en charge du format DXGI pour le matériel de niveau de fonctionnalité Direct3D 12.0
• Prise en charge du format DXGI pour le matériel de niveau de fonctionnalité Direct3D 11.1
• Prise en charge du format DXGI pour le matériel de niveau de fonctionnalité Direct3D 11.0
• Prise en charge matérielle des formats Direct3D 10Level9
• Prise en charge matérielle des formats Direct3D 10.1
• Prise en charge matérielle des formats Direct3D 10

Valeur retournée

Type : HRESULT

Retourne l’une des DXGI_ERROR suivantes.

Notes

FindClosestMatchingMode se comporte comme IDXGIOutput1::FindClosestMatchingMode1, sauf que FindClosestMatchingMode considère uniquement les modes d’affichage mono. IDXGIOutput1::FindClosestMatchingMode1 prend uniquement en compte les modes stéréo si vous définissez le membre Stéréo dans la structure DXGI_MODE_DESC1 vers laquelle pModeToMatch pointe et considère uniquement les modes mono si Stereo n’est pas défini.

IDXGIOutput1::FindClosestMatchingMode1 retourne un jeu de modes d’affichage correspondant avec uniquement des modes stéréo ou uniquement des modes mono. FindClosestMatchingMode se comporte comme si vous aviez spécifié le mode d’entrée comme mono.

Spécifications

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

Voir aussi

IDXGIOutput