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) 。

[out] ppvAdapter

类型: void**

指向适配器的 IDXGIAdapter 接口指针的地址。

此参数不能为 NULL。

返回值

类型: HRESULT

如果成功,则返回 S_OK ;否则为错误代码。 有关错误代码列表,请参阅 DXGI_ERROR

注解

此方法允许开发人员选择他们认为最适合其应用创建和使用的每个设备的 GPU。

此方法类似于 IDXGIFactory1::EnumAdapters1,但它接受 GPU 首选项来重新排序适配器枚举。 它返回给定 GPU 首选项的相应 IDXGIAdapter 。 它与采用 IDXGIAdapterD3DCreateDevice 函数结合使用。

GpuPreference 参数指定DXGI_GPU_PREFERENCE_UNSPECIFIED时,此方法等效于调用 IDXGIFactory1::EnumAdapters1

GpuPreference 参数指定DXGI_GPU_PREFERENCE_MINIMUM_POWER时,ppvAdapter 中返回的适配器的首选项顺序将为:

1. i GPU (集成 GPU)
2. d GPU (离散 GPU)
3. x GPU (外部 GPU)

GpuPreference 参数指定DXGI_GPU_PREFERENCE_HIGH_PERFORMANCE时,ppvAdapter 中返回的适配器的首选项顺序将为:

1. x GPU
2. dGPU
3. iGPU

要求

   
最低受支持的客户端 Windows 10版本 1803 [仅限桌面应用]
最低受支持的服务器 Windows Server 版本 1709 [仅限桌面应用]
目标平台 Windows
标头 dxgi1_6.h
Library Dxgi.lib

另请参阅

IDXGIFactory6

xGPU UWP 示例

xGPU 桌面示例