D3DKMT_ENUMADAPTERS3结构(d3dkmthk.h)

D3DKMT_ENUMADAPTERS3 结构提供有关系统上的适配器的信息。

语法

typedef struct _D3DKMT_ENUMADAPTERS3 {
  [in]     D3DKMT_ENUMADAPTERS_FILTER Filter;
  [in/out] ULONG                      NumAdapters;
  [out]    D3DKMT_ADAPTERINFO         *pAdapters;
} D3DKMT_ENUMADAPTERS3;

成员

[in] Filter

包含枚举筛选器标志的 D3DKMT_ENUMADAPTERS_FILTER 联合。 Filter 中的结构可以是以下值的按位 OR。 有关详细信息,请参阅“备注”。

价值 意义
IncludeComputeOnly 设置后,枚举 ComputeOnly 适配器。
IncludeDisplayOnly 设置后,枚举 DisplayOnly 适配器。
IncludeVirtualGpuOnly 设置后,枚举 GPU-P 适配器。 这些适配器仅用于虚拟机内部。 驱动程序为此类适配器设置 DXGK_DRIVERCAPS::MiscCaps.VirtualGpuOnly 上限,以避免在主机 OS 中枚举。 从 Windows 11 版本 24H2(WDDM 3.2)开始可用。
保留 保留;请勿使用。

[in/out] NumAdapters

适配器数。

在输入时,NumAdapters 指定可在空 pAdapters 数组中返回多少个适配器。 NumAdapters 的可能返回值为:

  • pAdapters 为非 null 时返回成功时,NumAdapters 包含 pAdapters 数组中返回的适配器数。
  • pAdapters 为 null 时返回成功,NumAdapters 包含支持的最大适配器计数。
  • pAdapters 为非 null 时返回失败时,未定义 NumAdapters

[out] pAdapters

用于接收每个适配器信息的 D3DKMT_ADAPTERINFO 结构的可选数组。

言论

如果未在 筛选器中设置任何标志,则仍会枚举适配器,但 D3DKMTEnumAdapters3 将枚举比 D3DKMTEnumAdapters2更少的适配器。 具体而言,D3DKMTEnumAdapters3 将:

  • 将 ComputeOnly 适配器从默认枚举中排除,以避免中断应用程序。
  • 将 DisplayOnly 适配器从默认枚举中排除。

要求

要求 价值
最低支持的客户端 Windows 10 版本 2004
标头 d3dkmthk.h

另请参阅

D3DKMT_ADAPTERINFO

D3DKMTEnumAdapters3

PFND3DKMT_ENUMADAPTERS3