IDXGIFactory6::EnumAdapterByGpuPreference 메서드(dxgi1_6.h)

지정된 GPU 기본 설정에 따라 그래픽 어댑터를 열거합니다.

구문

HRESULT EnumAdapterByGpuPreference(
  [in]  UINT                Adapter,
  [in]  DXGI_GPU_PREFERENCE GpuPreference,
  [in]  REFIID              riid,
  [out] void                **ppvAdapter
);

매개 변수

[in] Adapter

형식: UINT

열거할 어댑터의 인덱스입니다. 인덱스는 GpuPreference에 지정된 기본 설정 순서입니다. 예를 들어 DXGI_GPU_PREFERENCE_HIGH_PERFORMANCE 지정된 경우 가장 성능이 뛰어난 어댑터는 인덱스 0에 있고 두 번째로 높은 어댑터는 인덱스 1에 있습니다.

[in] GpuPreference

형식: DXGI_GPU_PREFERENCE

앱에 대한 GPU 기본 설정입니다.

[in] riid

형식: REFIID

ppvAdapter 매개 변수에서 참조하는 IDXGIAdapter 개체의 GUID(Globally Unique Identifier)입니다.

[out] ppvAdapter

형식: void**

어댑터에 대한 IDXGIAdapter 인터페이스 포인터의 주소입니다.

이 매개 변수는 NULL이 아니어야 합니다.

반환 값

형식: HRESULT

성공하면 S_OK 반환합니다. 그렇지 않으면 오류 코드입니다. 오류 코드 목록은 DXGI_ERROR 참조하세요.

설명

이 방법을 사용하면 개발자가 앱에서 만들고 활용하는 각 디바이스에 가장 적합한 GPU를 선택할 수 있습니다.

이 메서드는 IDXGIFactory1::EnumAdapters1과 비슷하지만 어댑터 열거형의 순서를 다시 지정하는 GPU 기본 설정을 허용합니다. 지정된 GPU 기본 설정에 적합한 IDXGIAdapter 를 반환합니다. IDXGIAdapter를 사용하는 D3DCreateDevice 함수와 함께 사용됩니다.

gpuPreference 매개 변수에 대해 DXGI_GPU_PREFERENCE_UNSPECIFIED 지정한 경우 이 메서드는 IDXGIFactory1::EnumAdapters1을 호출하는 것과 같습니다.

gpuPreference 매개 변수에 대해 DXGI_GPU_PREFERENCE_MINIMUM_POWER 지정하면 ppvAdapter에서 반환되는 어댑터에 대한 기본 설정 순서는 다음과 같습니다.

1. iGPU(통합 GPU)

2. dGPU(불연속 GPU)

3. xGPU(외부 GPU)

gpuPreference 매개 변수에 대해 DXGI_GPU_PREFERENCE_HIGH_PERFORMANCE 지정하면 ppvAdapter에서 반환된 어댑터에 대한 기본 설정 순서는 다음과 같습니다.

1. xGPU

2. dGPU

3. iGPU

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 10 버전 1803 [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server, 버전 1709 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	dxgi1_6.h
라이브러리	Dxgi.lib

추가 정보

IDXGIFactory6

xGPU UWP 샘플

xGPU 데스크톱 샘플