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 멤버를 지정할 수 없습니다. Width 또는 Height 값이 0이면 값이 지정되지 않음을 나타냅니다. Width 또는 Height가 0이면 둘 다 0이어야 합니다. RefreshRate의 숫자 및 분모 0은 지정되지 않았음을 나타냅니다. DXGI_MODE_DESC 다른 멤버에는 멤버가 지정되지 않았음을 나타내는 열거형 값이 있습니다. pConcernedDevice가 NULL이면 형식을 DXGI_FORMAT_UNKNOWN 수 없습니다.
[out] pClosestMatch
형식: DXGI_MODE_DESC*
pModeToMatch와 가장 일치하는 모드입니다.
[in, optional] pConcernedDevice
형식: IUnknown*
Direct3D 디바이스 인터페이스에 대한 포인터입니다. 이 매개 변수가 NULL이면 형식이 pModeToMatch 와 일치하는 모드만 반환됩니다. 그렇지 않으면 디바이스에서 검색을 지원하는 형식만 반환됩니다. 각 기능 수준에서 디바이스에서 검색할 수 있도록 지원되는 형식에 대한 자세한 내용은 다음을 수행합니다.
- DXGI Format Support for Direct3D Feature Level 12.1 Hardware(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 구조에서 스테레오 멤버를 설정하고 스테레오가 설정되지 않은 경우 모노 모드만 고려하는 경우에만 스테레오 모드를 고려합니다.
IDXGIOutput1::FindClosestMatchingMode1 은 스테레오 모드만 사용하거나 모노 모드만 사용하여 일치하는 디스플레이 모드 집합을 반환합니다. FindClosestMatchingMode 는 입력 모드를 mono로 지정한 것처럼 동작합니다.
요구 사항
대상 플랫폼 | Windows |
헤더 | dxgi.h |
라이브러리 | DXGI.lib |