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 的成员，以指示该成员没有首选项。 如果宽度或高度值为 0，则表示该值未指定。 如果 Width 或 Height 为 0，则两者都必须为 0。 RefreshRate 中的分子和分母为 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 格式支持
• DXGI Format Support for Direct3D Feature Level 12.0 Hardware（Direct3D 功能级别 12.0 硬件的 DXGI 格式支持）
• DXGI Format Support for Direct3D Feature Level 11.1 Hardware（Direct3D 功能级别 11.1 硬件的 DXGI 格式支持）
• DXGI Format Support for Direct3D Feature Level 11.0 Hardware（Direct3D 功能级别 11.0 硬件的 DXGI 格式支持）
• Hardware Support for Direct3D 10Level9 Formats（Direct3D 10Level9 格式的硬件支持）
• Hardware Support for Direct3D 10.1 Formats（Direct3D 10.1 格式的硬件支持）
• Hardware Support for Direct3D 10 Formats（Direct3D 10 格式的硬件支持）

返回值

类型： HRESULT

返回以下 DXGI_ERROR之一。

备注

FindClosestMatchingMode 的行为类似于 IDXGIOutput1：：FindClosestMatchingMode1 ，但 FindClosestMatchingMode 只考虑单声道显示模式。 IDXGIOutput1：：FindClosestMatchingMode1 仅考虑在 pModeToMatch 指向的DXGI_MODE_DESC1结构中设置 Stereo 成员时考虑立体声模式，如果未设置 Stereo，则仅考虑单声道模式。

IDXGIOutput1：：FindClosestMatchingMode1 返回仅具有立体声模式或单声道模式的匹配显示模式集。 FindClosestMatchingMode 的行为就像将输入模式指定为单声道一样。

要求

目标平台	Windows
标头	dxgi.h
Library	DXGI.lib

另请参阅

IDXGIOutput