IDXGIOutput：：FindClosestMatchingMode 方法 (dxgi.h)

[從 Direct3D 11.1 開始，我們建議不要再使用 FindClosestMatchingMode 來尋找最符合所要求顯示模式的顯示模式。 請改用支援立體顯示模式的 IDXGIOutput1：：FindClosestMatchingMode1。

尋找最符合所要求顯示模式的顯示模式。

語法

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

參數

[in] pModeToMatch

類型：const DXGI_MODE_DESC*

所需的顯示模式 (請參閱 DXGI_MODE_DESC) 。 無法指定 DXGI_MODE_DESC 的成員，表示該成員沒有喜好設定。 Width或Height的值為 0 表示未指定值。 如果 Width 或 Height 為 0，則兩者都必須是 0。 RefreshRate中的 Numerator 和分母為 0 表示未指定。 DXGI_MODE_DESC的其他成員具有列舉值，表示成員未指定。 如果 pConcernedDevice 為 Null， 則無法DXGI_FORMAT_UNKNOWN Format 。

[out] pClosestMatch

類型： DXGI_MODE_DESC*

最符合 pModeToMatch的模式。

[in, optional] pConcernedDevice

類型： IUnknown*

Direct3D 裝置介面的指標。 如果此參數為 Null，則只會傳回其格式符合 pModeToMatch 之格式的模式;否則，只會傳回裝置支援掃描的那些格式。 如需每個功能層級裝置所支援掃描格式的相關資訊：

• Direct3D 功能層級 12.1 硬體的 DXGI 格式支援
• Direct3D 功能層級 12.0 硬體的 DXGI 格式支援
• Direct3D 功能層級 11.1 硬體的 DXGI 格式支援
• Direct3D 功能層級 11.0 硬體的 DXGI 格式支援
• Direct3D 10Level9 格式的硬體支援
• Direct3D 10.1 格式的硬體支援
• Direct3D 10 格式的硬體支援

傳回值

類型： HRESULT

傳回下列其中一個 DXGI_ERROR。

備註

FindClosestMatchingMode 的行為類似于 IDXGIOutput1：：FindClosestMatchingMode1 ， 但 FindClosestMatchingMode 只考慮單色顯示模式。 IDXGIOutput1：：FindClosestMatchingMode1只有在您設定 pModeToMatch所指向之DXGI_MODE_DESC1結構中的「立體」成員時，只會考慮立體模式，如果未設定 Stereo，則只會考慮單聲模式。

IDXGIOutput1：：FindClosestMatchingMode1 會傳回只有立體模式或僅單聲道模式的相符顯示模式集。 FindClosestMatchingMode 的行為就像您將輸入模式指定為 mono 一樣。

需求

目標平台	Windows
標頭	dxgi.h
程式庫	DXGI.lib

另請參閱

IDXGIOutput