IDirect3D9::GetAdapterIdentifier 方法 (d3d9.h)
描述实例化 IDirect3D9 接口时系统中存在的物理显示适配器。
语法
HRESULT GetAdapterIdentifier(
[in] UINT Adapter,
[in] DWORD Flags,
[out] D3DADAPTER_IDENTIFIER9 *pIdentifier
);
参数
[in] Adapter
类型: UINT
表示显示适配器的序号。 D3DADAPTER_DEFAULT始终是主要显示适配器。 此参数的最小值为 0,此参数的最大值比 GetAdapterCount 返回的值少 1。
[in] Flags
类型: DWORD
标志设置 D3DADAPTER_IDENTIFIER9 的 WHQLLevel 成员。 标志可以设置为 0 或D3DENUM_WHQL_LEVEL。 如果指定了D3DENUM_WHQL_LEVEL,则此调用可以连接到 Internet,以 (WHQL) 证书下载新的 Microsoft Windows 硬件质量实验室。
Direct3D 9 和 Direct3D 9Ex 之间的差异:
D3DENUM_WHQL_LEVEL已弃用,适用于在 Windows Vista、Windows Server 2008、Windows 7 和 Windows Server 2008 R2 上运行的 Direct3D9Ex (或更多当前操作系统) 。 这些操作系统中的任何一个在 D3DADAPTER_IDENTIFIER9 的 WHQLLevel 成员中返回 1,而不检查驱动程序的状态。
[out] pIdentifier
指向 D3DADAPTER_IDENTIFIER9 结构的指针,该结构要填充描述此适配器的信息。 如果 适配器 大于或等于系统中的适配器数,则此结构将被归零。
返回值
类型: HRESULT
如果该方法成功,则返回值D3D_OK。 如果 Adapter 在范围之外、Flags 包含无法识别的参数,或者 pIdentifier 为 NULL 或指向不可写的内存,则返回D3DERR_INVALIDCALL。
要求
要求 | 值 |
---|---|
目标平台 | Windows |
标头 | d3d9.h (包括 D3D9.h) |
Library | D3D9.lib |