Share via

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

[out] pClosestMatch

Тип: DXGI_MODE_DESC*

Режим, который наиболее точно соответствует pModeToMatch.

[in, optional] pConcernedDevice

Тип: IUnknown*

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

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

Тип: HRESULT

Возвращает одно из следующих DXGI_ERROR.

Комментарии

FindClosestMatchingMode ведет себя аналогично IDXGIOutput1::FindClosestMatchingMode1 , за исключением того , что FindClosestMatchingMode учитывает только моно-режимы отображения. IDXGIOutput1::FindClosestMatchingMode1 учитывает только стереорежимы, если задан элемент Stereo в структуре DXGI_MODE_DESC1 , на которую указывает pModeToMatch , и учитывает только монорежимы, если стерео не задан.

IDXGIOutput1::FindClosestMatchingMode1 возвращает соответствующий набор режимов отображения, содержащий только стереорежимы или только монорежимы. FindClosestMatchingMode ведет себя так, как если бы вы указали режим ввода как моно.

Требования

   
Целевая платформа Windows
Header dxgi.h
Библиотека DXGI.lib

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

IDXGIOutput