D3DKMTEnumAdapters3 函数（d3dkmthk.h）

提供用于枚举系统上的图形和显示适配器的信息。

语法

NTSTATUS D3DKMTEnumAdapters3(
  [in/out] D3DKMT_ENUMADAPTERS3 *unnamedParam1
);

[in/out] unnamedParam1

D3DKMT_ENUMADAPTERS3 结构。调用方传入数组大小和空数组空间。被调用方验证数组中有足够的空间，填写数组，并传回使用了多少数组。

此函数返回 NTSTATUS。

返回代码	描述
STATUS_BUFFER_TOO_SMALL	提供的数组太小，无法接收所有适配器。
STATUS_INVALID_PARAMETER	pEnumAdapters 成员为 null，或者为无效的内存区域。
STATUS_NO_MEMORY	无法分配内存来满足操作。

当 D3DKMT_ENUMADAPTERS3：:p Adapters 为 null 时，D3DKMT_ENUMADAPTERS3：：NumAdapters 设置为支持的最大适配器计数。被调用方通常会调用该方法，首先检索支持的最大适配器计数。

当被调用方成功枚举适配器时，它将负责显式管理适配器D3DKMT_HANDLEs的生命周期。这些句柄通过 pEnumAdapters 返回到被调用方，并且必须使用 D3DKMTCloseAdapter关闭这些句柄。

设置任何D3DKMT_ENUMADAPTERS3：：筛选器标志仍将枚举适配器，但 D3DKMTEnumAdapters2 枚举的适配器较少。 ComputeOnly 适配器被排除在默认枚举中，以避免中断应用程序。 DisplayOnly 适配器也排除在默认枚举中。