IDXGIOutput1::GetDisplayModeList1 메서드(dxgi1_2.h)
요청된 형식 및 기타 입력 옵션과 일치하는 표시 모드를 가져옵니다.
구문
HRESULT GetDisplayModeList1(
DXGI_FORMAT EnumFormat,
UINT Flags,
[in, out] UINT *pNumModes,
[out, optional] DXGI_MODE_DESC1 *pDesc
);
매개 변수
EnumFormat
색 형식에 대한 DXGI_FORMAT 형식의 값입니다.
Flags
비트 OR 연산을 사용하여 결합된 DXGI_ENUM_MODES 형식 값의 조합입니다. 결과 값은 표시 모드에 포함할 옵션을 지정합니다. 크기 조정이 필요한 디스플레이 모드를 노출하려면 DXGI_ENUM_MODES_SCALING 지정해야 합니다. 크기 조정이 필요하지 않고 디스플레이 출력에 직접 해당하는 가운데 모드는 기본적으로 열거됩니다.
[in, out] pNumModes
GetDisplayModeList1이 pDesc가 가리키는 메모리 블록에서 반환하는 표시 모드 수를 수신하는 변수에 대한 포인터입니다. pNumModes가 형식 및 옵션과 일치하는 표시 모드 수를 반환하도록 pDesc를 NULL로 설정합니다. 그렇지 않으면 pNumModes 는 pDesc에서 반환된 표시 모드 수를 반환합니다.
[out, optional] pDesc
표시 모드 목록에 대한 포인터입니다. 을 NULL 로 설정하여 표시 모드 수를 가져옵니다.
반환 값
DXGI_ERROR 항목에 설명된 오류 코드 중 하나를 반환합니다. 이 메서드를 호출한 후 사용 가능한 디스플레이 모드가 즉시 변경되는 경우는 드물지만, 이 경우 DXGI_ERROR_MORE_DATA 반환됩니다(모든 디스플레이 모드에 충분한 공간이 없는 경우).
설명
GetDisplayModeList1 은 GetDisplayModeList 에서 업데이트되어 업데이트된 모드 설명인 DXGI_MODE_DESC1 구조 목록을 반환합니다. GetDisplayModeList는 GetDisplayModeList가 스테레오 모드를 포함하여 DXGI_ENUM_MODES 지정된 모든 모드를 반환할 수 있으므로 GetDisplayModeList1을 호출하는 것처럼 동작합니다. 그러나 GetDisplayModeList 는 이전 모드 설명이며 스테레오 모드를 나타내지 않는 DXGI_MODE_DESC 구조 목록을 반환합니다.
Flags 매개 변수에 DXGI_ENUM_MODES_STEREO 플래그를 지정하지 않는 한 GetDisplayModeList1 메서드는 스테레오 모드를 열거하지 않습니다. DXGI_ENUM_MODES_STEREO 지정하면 pDesc 매개 변수가 가리키는 반환된 모드 목록에 스테레오 모드가 포함됩니다. 즉, 메서드는 스테레오 모드와 모노 모드를 모두 반환합니다.
일반적으로 창 모드에서 전체 화면 모드로 전환하면 스왑 체인이 스왑 체인의 해상도, 색 깊이 및 새로 고침 속도를 충족하거나 초과하는 디스플레이 모드를 자동으로 선택합니다. 디스플레이 모드에 대한 더 많은 제어를 실행하려면 GetDisplayModeList1 을 사용하여 모니터 기능에 대해 유효성이 검사된 디스플레이 모드 집합 또는 데스크톱과 일치하는 모든 모드(데스크톱 설정이 모니터에 대해 유효성을 검사하지 않은 경우)를 폴링합니다.
다음 예제 코드는 GetDisplayModeList1 을 두 번 호출해야 한다는 것을 보여줍니다. 먼저 GetDisplayModeList1 을 호출하여 사용 가능한 모드 수를 가져옵니다. 두 번째 호출은 GetDisplayModeList1 을 호출하여 모드에 대한 설명을 반환합니다.
UINT num = 0;
DXGI_FORMAT format = DXGI_FORMAT_R32G32B32A32_FLOAT;
UINT flags = DXGI_ENUM_MODES_INTERLACED;
pOutput->GetDisplayModeList1( format, flags, &num, 0);
...
DXGI_MODE_DESC1 * pDescs = new DXGI_MODE_DESC1[num];
pOutput->GetDisplayModeList1( format, flags, &num, pDescs);
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows 7용 Windows 8 및 플랫폼 업데이트 [데스크톱 앱 | UWP 앱] |
| 지원되는 최소 서버 | Windows Server 2008 R2용 Windows Server 2012 및 플랫폼 업데이트 [데스크톱 앱 | UWP 앱] |
| 대상 플랫폼 | Windows |
| 헤더 | dxgi1_2.h |
| 라이브러리 | DXGI.lib |