PFND3DKMT_ENUMADAPTERS3回调函数 (d3dkmthk.h)
PFND3DKMT_ENUMADAPTERS3回调函数枚举系统上的图形和显示适配器。
PFND3DKMT_ENUMADAPTERS3 Pfnd3dkmtEnumadapters3;
NTSTATUS Pfnd3dkmtEnumadapters3(
[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::Filter 标志仍将枚举适配器,但适配器数少于 PFND3DKMT_ENUMADAPTERS2 枚举。 ComputeOnly 适配器被排除在默认枚举外,以避免中断应用程序。 DisplayOnly 适配器也排除在默认枚举外。
要求 | 值 |
---|---|
最低受支持的客户端 | Windows 10 版本 2004 |
标头 | d3dkmthk.h |