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 |