다음을 통해 공유

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 멤버를 지정하지 않을 수 있습니다. 이는 해당 멤버에 대한 기본 설정이 없음을 나타냅니다. Width 또는 Height 값이 0이면 값이 지정되지 않음을 나타냅니다. Width 또는 Height가 0이면 둘 다 0이어야 합니다. RefreshRate의 숫자 및 분모 0은 지정되지 않았음을 나타냅니다. DXGI_MODE_DESC1 다른 멤버에는 멤버가 지정되지 않았음을 나타내는 열거형 값이 있습니다. pConcernedDevice가 NULL이면 DXGI_MODE_DESC1Format 멤버를 DXGI_FORMAT_UNKNOWN 수 없습니다.

[out] pClosestMatch

pModeToMatch에 설명된 표시 모드와 가장 일치하는 표시 모드에 대한 설명을 수신하는 DXGI_MODE_DESC1 구조체에 대한 포인터입니다.

[in, optional] pConcernedDevice

Direct3D 디바이스 인터페이스에 대한 포인터입니다. 이 매개 변수가 NULL이면 FindClosestMatchingMode1 은 형식이 pModeToMatch와 일치하는 모드만 반환합니다. 그렇지 않으면 FindClosestMatchingMode1 은 디바이스에서 검색에 지원되는 형식만 반환합니다. 각 기능 수준에서 디바이스에서 검색할 수 있도록 지원되는 형식에 대한 자세한 내용은 다음을 수행합니다.

반환 값

DXGI_ERROR 항목에 설명된 오류 코드 중 하나를 반환합니다.

설명

Direct3D 디바이스에는 UNORM 형식이 필요합니다.

FindClosestMatchingMode1 은 pModeToMatch에서 지정한 모드와 가장 일치하는 사용 가능한 디스플레이 모드를 찾습니다.

pModeToMatch가 스테레오 모드를 입력으로 지정하도록 가리키는 DXGI_MODE_DESC1 구조체에서 Stereo 멤버를 설정하는 경우 FindClosestMatchingMode1은 스테레오 모드만 고려합니다. FindClosestMatchingMode1 은 스테레오 가 설정되지 않은 경우 모노 모드만 고려합니다.

FindClosestMatchingMode1 은 다음과 같은 순서로 표시 모드(즉, 지정된 모든 멤버 또는 지정되지 않은 모든 등)의 비슷한 순위 멤버를 확인합니다.

  1. ScanlineOrdering
  2. 크기 조정
  3. 형식
  4. 해결 방법
  5. RefreshRate
FindClosestMatchingMode1이 특정 멤버에 대해 가장 가까운 값을 결정하는 경우 이전에 일치하는 멤버를 사용하여 표시 모드 목록 선택을 필터링하고 다른 멤버를 무시합니다. 예를 들어 FindClosestMatchingMode1이 해상도와 일치하는 경우 RefreshRate를 무시하면서 특정 ScanlineOrdering, Scaling 및 Format으로 표시 모드 목록을 이미 필터링했습니다. 이 순서는 FindClosestMatchingMode1의 모든 사용 시나리오에 대한 절대 순서를 정의하지 않습니다. 애플리케이션은 처음에 일부 값을 선택할 수 있으므로 멤버 확인 순서를 효과적으로 변경할 수 있습니다.

FindClosestMatchingMode1 은 디스플레이 모드의 멤버를 일반적으로 지정된 순서로 한 번에 하나씩 일치합니다.

멤버가 지정되지 않은 경우 FindClosestMatchingMode1 은 이 출력과 관련된 데스크톱 값에 몰두합니다. 이 출력이 데스크톱의 일부가 아닌 경우 FindClosestMatchingMode1 은 기본 데스크톱 출력을 사용하여 값을 찾습니다. 애플리케이션이 완전히 지정되지 않은 디스플레이 모드를 사용하는 경우 FindClosestMatchingMode1 은 일반적으로 이 출력의 데스크톱 설정과 일치하는 디스플레이 모드를 반환합니다.
지정되지 않은 멤버는 지정된 멤버보다 우선 순위가 낮기 때문에 FindClosestMatchingMode1 은 지정된 멤버보다 나중에 지정되지 않은 멤버를 확인합니다.

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows 7용 Windows 8 및 플랫폼 업데이트 [데스크톱 앱 | UWP 앱]
지원되는 최소 서버 Windows Server 2008 R2용 Windows Server 2012 및 플랫폼 업데이트 [데스크톱 앱 | UWP 앱]
대상 플랫폼 Windows
헤더 dxgi1_2.h
라이브러리 DXGI.lib

추가 정보

IDXGIOutput1