IDXGIOutput1::FindClosestMatchingMode1-Methode (dxgi1_2.h)

Sucht nach dem Anzeigemodus, der dem angeforderten Anzeigemodus am ehesten entspricht.

Syntax

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

Parameter

[in] pModeToMatch

Ein Zeiger auf die DXGI_MODE_DESC1-Struktur , die den abzugleichenden Anzeigemodus beschreibt. Member von DXGI_MODE_DESC1 können nicht angegeben werden, was darauf hinweist, dass dieses Element nicht bevorzugt wird. Der Wert 0 für Breite oder Höhe gibt an, dass der Wert nicht angegeben ist. Wenn Breite oder Höhe 0 ist, muss beide 0 sein. Ein Zähler und ein Nenner von 0 in RefreshRate geben an, dass er nicht angegeben ist. Andere Member von DXGI_MODE_DESC1 verfügen über Enumerationswerte, die angeben, dass der Member nicht angegeben ist. Wenn pConcernedDeviceNULL ist, kann der Format-Member von DXGI_MODE_DESC1 nicht DXGI_FORMAT_UNKNOWN werden.

[out] pClosestMatch

Ein Zeiger auf die DXGI_MODE_DESC1-Struktur , die eine Beschreibung des Anzeigemodus empfängt, der dem unter pModeToMatch beschriebenen Anzeigemodus am ehesten entspricht.

[in, optional] pConcernedDevice

Ein Zeiger auf die Direct3D-Geräteschnittstelle. Wenn dieser Parameter NULL ist, gibt FindClosestMatchingMode1 nur Modi zurück, deren Format dem von pModeToMatch entspricht. Andernfalls gibt FindClosestMatchingMode1 nur die Formate zurück, die vom Gerät zum Scannen unterstützt werden. Informationen zu den Formaten, die für das Scannen vom Gerät auf jeder Featureebene unterstützt werden:

• DXGI-Formatunterstützung für Direct3D-Hardware der Featureebene 12.1
• DXGI-Formatunterstützung für Direct3D-Hardware der Featureebene 12.0
• DXGI-Formatunterstützung für Direct3D-Hardware der Featureebene 11.1
• DXGI-Formatunterstützung für Direct3D-Hardware der Featureebene 11.0
• Hardwareunterstützung für Direct3D 10Level9-Formate
• Hardwareunterstützung für Direct3D 10.1-Formate
• Hardwareunterstützung für Direct3D 10-Formate

Rückgabewert

Gibt einen der im Thema DXGI_ERROR beschriebenen Fehlercodes zurück.

Hinweise

Direct3D-Geräte erfordern UNORM-Formate.

FindClosestMatchingMode1 findet den verfügbaren Anzeigemodus, der dem in pModeToMatch angegebenen Modus am nächsten kommt.

Wenn Sie den Stereo-Member in der DXGI_MODE_DESC1-Struktur festlegen, auf die pModeToMatch verweist, um einen Stereomodus als Eingabe anzugeben, berücksichtigt FindClosestMatchingMode1 nur Stereomodi. FindClosestMatchingMode1 berücksichtigt nur mono-Modi, wenn Stereo nicht festgelegt ist.

FindClosestMatchingMode1 löst ähnlich bewertete Member von Anzeigemodi (d. a. alle angegebenen oder nicht angegebenen usw.) in der folgenden Reihenfolge auf:

1. ScanlineOrdering
2. Skalieren
3. Format
4. Lösung
5. RefreshRate

Wenn FindClosestMatchingMode1 den nächstgelegenen Wert für ein bestimmtes Element bestimmt, werden zuvor übereinstimmende Member verwendet, um die Listenoptionen für den Anzeigemodus zu filtern, und andere Member werden ignoriert. Wenn FindClosestMatchingMode1 beispielsweise mit der Auflösung übereinstimmt, wurde die Anzeigemodusliste bereits nach einem bestimmten ScanlineOrdering, Skalierung und Format gefiltert, während RefreshRate ignoriert wird. Diese Reihenfolge definiert nicht die absolute Reihenfolge für jedes Verwendungsszenario von FindClosestMatchingMode1, da die Anwendung zunächst einige Werte auswählen kann, was die Reihenfolge der Auflösung von Membern effektiv ändert.

FindClosestMatchingMode1 gleicht Elemente des Anzeigemodus einzeln ab, in der Regel in einer angegebenen Reihenfolge.

Wenn ein Member nicht angegeben ist, wird FindClosestMatchingMode1 zu den Werten für den Desktop im Zusammenhang mit dieser Ausgabe verwendet. Wenn diese Ausgabe nicht Teil des Desktops ist, verwendet FindClosestMatchingMode1 die Standarddesktopausgabe, um Werte zu finden. Wenn eine Anwendung einen vollständig nicht angegebenen Anzeigemodus verwendet, gibt FindClosestMatchingMode1 in der Regel einen Anzeigemodus zurück, der den Desktopeinstellungen für diese Ausgabe entspricht.
Da nicht angegebene Member eine niedrigere Priorität als angegebene Member haben, löst FindClosestMatchingMode1 nicht angegebene Member später als angegebene Member auf.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 8 und Plattformupdate für Windows 7 [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2012 und Plattformupdate für Windows Server 2008 R2 [Desktop-Apps | UWP-Apps]
Zielplattform	Windows
Kopfzeile	dxgi1_2.h
Bibliothek	DXGI.lib

Weitere Informationen

IDXGIOutput1