Метод 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 могут быть неопределенными, что указывает на отсутствие предпочтений для этого члена. Значение 0 для ширины или высоты указывает, что значение не указано. Если значение ширины или высоты равно 0, оба значения должны иметь значение 0. Числитель и знаменатель 0 в RefreshRate указывают, что он не указан. Другие члены DXGI_MODE_DESC1 имеют значения перечисления, указывающие, что элемент не указан. Если pConcernedDevice имеет значение NULL, элемент FormatDXGI_MODE_DESC1 нельзя DXGI_FORMAT_UNKNOWN.

[out] pClosestMatch

Указатель на структуру DXGI_MODE_DESC1 , получающую описание режима отображения, наиболее точно соответствующего режиму отображения, описанному в разделе pModeToMatch.

[in, optional] pConcernedDevice

Указатель на интерфейс устройства Direct3D. Если этот параметр имеет значение NULL, FindClosestMatchingMode1 возвращает только режимы, формат которых соответствует формату pModeToMatch; В противном случае Функция FindClosestMatchingMode1 возвращает только те форматы, которые поддерживаются устройством для сканирования. Сведения о форматах, поддерживаемых для сканирования устройства на каждом уровне компонентов:

• Поддержка формата DXGI для оборудования уровня компонентов Direct3D 12.1
• Поддержка формата DXGI для оборудования Уровня компонентов Direct3D 12.0
• Поддержка формата DXGI для оборудования Уровня компонентов Direct3D 11.1
• Поддержка формата DXGI для оборудования Уровня компонентов Direct3D 11.0
• Поддержка оборудования для форматов Direct3D 10Level9
• Поддержка оборудования для форматов Direct3D 10.1
• Поддержка оборудования для форматов Direct3D 10

Возвращаемое значение

Возвращает один из кодов ошибок, описанных в разделе DXGI_ERROR .

Комментарии

Для устройств Direct3D требуются форматы UNORM.

FindClosestMatchingMode1 находит ближайший соответствующий доступный режим отображения к режиму, указанному в pModeToMatch.

Если в структуре DXGI_MODE_DESC1 задан элемент Stereo, на который pModeToMatch указывает на указание стереорежима в качестве входных данных, FindClosestMatchingMode1 рассматривает только стереорежимы. FindClosestMatchingMode1 учитывает только монорежимы, если параметр Stereo не задан.

FindClosestMatchingMode1 разрешает аналогично ранжированные члены режимов отображения (то есть все указанные или все неопределенные и т. д.) в следующем порядке:

1. ScanlineOrdering
2. Масштабирование
3. Формат
4. Решение
5. RefreshRate

Когда FindClosestMatchingMode1 определяет ближайшее значение для определенного элемента, он использует ранее сопоставленные элементы для фильтрации списков режима отображения и игнорирует другие элементы. Например, когда FindClosestMatchingMode1 соответствует разрешению, он уже отфильтровал список режима отображения по определенным параметрам ScanlineOrdering, Scaling и Format, в то время как не учитывает RefreshRate. Этот порядок не определяет абсолютный порядок для каждого сценария использования FindClosestMatchingMode1, так как приложение может изначально выбрать некоторые значения, что фактически изменяет порядок разрешения элементов.

FindClosestMatchingMode1 соответствует членам режима отображения по одному, обычно в указанном порядке.

Если элемент не указан, FindClosestMatchingMode1 тяготеет к значениям рабочего стола, связанным с этим выходным данным. Если эти выходные данные не являются частью рабочего стола, FindClosestMatchingMode1 использует выходные данные рабочего стола по умолчанию для поиска значений. Если приложение использует полностью неопределенный режим отображения, FindClosestMatchingMode1 обычно возвращает режим отображения, соответствующий параметрам рабочего стола для этого вывода.
Поскольку неуказаемые элементы имеют более низкий приоритет, чем указанные элементы, FindClosestMatchingMode1 разрешает неуказаемые элементы позже, чем указанные элементы.

Требования

Требование	Значение
Минимальная версия клиента	Windows 8 и обновление платформы для Windows 7 [классические приложения | Приложения UWP]
Минимальная версия сервера	Windows Server 2012 и обновление платформы для Windows Server 2008 R2 [классические приложения | Приложения UWP]
Целевая платформа	Windows
Header	dxgi1_2.h
Библиотека	DXGI.lib

См. также раздел

IDXGIOutput1