PFND3DKMT_ENUMADAPTERS2回调函数 (d3dkmthk.h)
PFND3DKMT_ENUMADAPTERS2回调函数枚举系统上的所有图形和显示适配器。
语法
PFND3DKMT_ENUMADAPTERS2 Pfnd3dkmtEnumadapters2;
NTSTATUS Pfnd3dkmtEnumadapters2(
const D3DKMT_ENUMADAPTERS2 *unnamedParam1
)
{...}
参数
unnamedParam1
_Inout_D3DKMT_ENUMADAPTERS2 * arg1
调用方传入数组大小和空数组空间。 被调用方验证数组中有足够的空间,填写数组,并传回使用了多少数组。
返回值
此函数返回 NTSTATUS。
返回代码 | 描述 |
---|---|
STATUS_BUFFER_TOO_SMALL | 如果提供的数组太小,无法接收所有适配器。 |
STATUS_INVALID_PARAMETER | pEnumAdapters 为 null 或为无效内存区域时。 |
STATUS_NO_MEMORY | 无法分配内存以满足操作时。 |
言论
当 D3DKMT_ENUMADAPTERS2::p Adapters 为 null 时,D3DKMT_ENUMADAPTERS2::NumAdapters 设置为支持的最大适配器计数。 被调用方通常会调用该方法,首先检索支持的最大适配器计数。
当被调用方成功枚举适配器时,它将负责显式管理适配器D3DKMT_HANDLEs的生命周期。 这些句柄通过 pEnumAdapters 返回到被调用方,并且必须使用 D3DKMTCloseAdapter关闭。
要求
要求 | 价值 |
---|---|
标头 | d3dkmthk.h |