D3DKMT_ENUMADAPTERS3 结构 (d3dkmthk.h)

  • 项目

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

语法

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 适配器。
预留 保留值；请勿使用。

[in/out] NumAdapters

适配器数。

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

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

[out] pAdapters

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

注解

如果在 Filter 中未设置任何标志，仍将枚举适配器，但 D3DKMTEnumAdapters3 将枚举比 D3DKMTEnumAdapters2 少的适配器。 具体而言， D3DKMTEnumAdapters3 将：

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

要求

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

另请参阅

D3DKMT_ADAPTERINFO

D3DKMTEnumAdapters3

PFND3DKMT_ENUMADAPTERS3