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 |