共用方式為


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 的成員,表示該成員沒有喜好設定。 WidthHeight的值為 0 表示未指定值。 如果 WidthHeight 為 0,則兩者都必須是 0。 RefreshRate中的 Numerator 和分母為 0 表示未指定。 DXGI_MODE_DESC的其他成員具有列舉值,表示成員未指定。 如果 pConcernedDeviceNull則無法DXGI_FORMAT_UNKNOWN Format

[out] pClosestMatch

類型: DXGI_MODE_DESC*

最符合 pModeToMatch的模式。

[in, optional] pConcernedDevice

類型: IUnknown*

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

傳回值

類型: HRESULT

傳回下列其中一個 DXGI_ERROR

備註

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

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

需求

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

另請參閱

IDXGIOutput