共用方式為


IDXGIOutput1::FindClosestMatchingMode1 方法 (dxgi1_2.h)

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

語法

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

參數

[in] pModeToMatch

描述要比對之顯示模式 之DXGI_MODE_DESC1 結構的指標。 DXGI_MODE_DESC1的成員可以未指定,這表示該成員沒有喜好設定。 WidthHeight 的值為 0 表示值未指定。 如果 WidthHeight 為 0,則兩者都必須是 0。 RefreshRate 中的 Numerator 和分母為 0 表示未指定。 DXGI_MODE_DESC1的其他成員具有列舉值,表示成員未指定。 如果 pConcernedDeviceNULL無法DXGI_FORMAT_UNKNOWN DXGI_MODE_DESC1的格式成員。

[out] pClosestMatch

DXGI_MODE_DESC1 結構的指標,接收最符合 pModeToMatch 所描述之顯示模式的描述。

[in, optional] pConcernedDevice

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

傳回值

傳回 DXGI_ERROR 主題中所述的其中一個錯誤碼。

備註

Direct3D 裝置需要 UNORM 格式。

FindClosestMatchingMode1 會尋找最接近您在 pModeToMatch 中指定的模式相符的可用顯示模式。

如果您在 pModeToMatch 指向的 DXGI_MODE_DESC1 結構中設定立體成員,以將立體模式指定為輸入,FindClosestMatchingMode1 只會考慮立體模式。 FindClosestMatchingMode1 若未設定 立體聲 ,只會考慮單聲道模式。

FindClosestMatchingMode1 會解析顯示模式的類似排名成員 (,也就是所有指定或全部未指定,依下列順序) :

  1. ScanlineOrdering
  2. 擴充
  3. 格式
  4. 解決方法
  5. RefreshRate
當 FindClosestMatchingMode1 判斷特定成員的最接近值時,它會使用先前比對的成員來篩選顯示模式清單選項,並忽略其他成員。 例如,當 FindClosestMatchingMode1 符合 Resolution 時,它已經依特定的 ScanlineOrdering縮放格式篩選顯示模式清單,同時忽略 RefreshRate。 此排序不會定義 FindClosestMatchingMode1 的每個使用案例的絕對順序,因為應用程式一開始可以選擇一些值,進而有效地變更解析成員的順序。

FindClosestMatchingMode1 會一次比對一個顯示模式的成員,通常是以指定的順序。

如果未指定成員, FindClosestMatchingMode1 會針對與這個輸出相關的桌面值進行 gravitas。 如果此輸出不是桌面的一部分, FindClosestMatchingMode1 會使用預設桌面輸出來尋找值。 如果應用程式使用完全未指定的顯示模式, FindClosestMatchingMode1 通常會傳回符合此輸出桌面設定的顯示模式。
由於未指定的成員優先順序低於指定的成員, 所以 FindClosestMatchingMode1 會比指定的成員晚於指定的成員解析未指定的成員。

規格需求

需求
最低支援的用戶端 適用於 Windows 7 的 Windows 8 和平臺更新 [傳統型應用程式 |UWP 應用程式]
最低支援的伺服器 適用於 Windows Server 2008 R2 的 Windows Server 2012 和平臺更新 [傳統型應用程式 |UWP 應用程式]
目標平台 Windows
標頭 dxgi1_2.h
程式庫 DXGI.lib

另請參閱

IDXGIOutput1