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 。 它旨在与采用 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
Library Dxgi.lib

另请参阅

IDXGIFactory6

xGPU UWP 示例

xGPU 桌面示例