IDXGIOutput::FindClosestMatchingMode-Methode (dxgi.h)

[Ab Direct3D 11.1 wird empfohlen, findClosestMatchingMode nicht mehr zu verwenden, um den Anzeigemodus zu finden, der dem angeforderten Anzeigemodus am ehesten entspricht. Verwenden Sie stattdessen IDXGIOutput1::FindClosestMatchingMode1, das den Stereoanzeigemodus unterstützt.]

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

Syntax

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

Parameter

[in] pModeToMatch

Typ: const DXGI_MODE_DESC*

Der gewünschte Anzeigemodus (siehe DXGI_MODE_DESC). Mitglieder von DXGI_MODE_DESC 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 sind, müssen beide 0 sein. Ein Zähler und der Nenner 0 in RefreshRate weisen darauf hin, dass es nicht angegeben ist. Andere Member von DXGI_MODE_DESC verfügen über Enumerationswerte, die angeben, dass der Member nicht angegeben ist. Wenn pConcernedDeviceNULL ist, kann Format nicht DXGI_FORMAT_UNKNOWN werden.

[out] pClosestMatch

Typ: DXGI_MODE_DESC*

Der Modus, der pModeToMatch am ehesten entspricht.

[in, optional] pConcernedDevice

Typ: IUnknown*

Ein Zeiger auf die Direct3D-Geräteschnittstelle. Wenn dieser Parameter NULL ist, werden nur Modi zurückgegeben, deren Format dem von pModeToMatch entspricht. andernfalls werden nur die Formate zurückgegeben, die für das Ausscannen vom Gerät unterstützt werden. Informationen zu den Formaten, die für das Ausscannen vom Gerät auf den einzelnen Featureebenen unterstützt werden:

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

Rückgabewert

Typ: HRESULT

Gibt eine der folgenden DXGI_ERROR zurück.

Hinweise

FindClosestMatchingMode verhält sich ähnlich wie IDXGIOutput1::FindClosestMatchingMode1 , außer FindClosestMatchingMode berücksichtigt nur die Mono-Anzeigemodi. IDXGIOutput1::FindClosestMatchingMode1 berücksichtigt nur Stereomodi, wenn Sie das Stereoelement in der DXGI_MODE_DESC1 Struktur festlegen, auf die pModeToMatch verweist, und nur Monomodi berücksichtigt, wenn Stereo nicht festgelegt ist.

IDXGIOutput1::FindClosestMatchingMode1 gibt einen übereinstimmenden Anzeigemodus zurück, der nur mit Stereomodi oder nur Monomodi festgelegt ist. FindClosestMatchingMode verhält sich so, als ob Sie den Eingabemodus als Mono angegeben haben.

Anforderungen

Zielplattform	Windows
Kopfzeile	dxgi.h
Bibliothek	DXGI.lib

Weitere Informationen

IDXGIOutput