D3DDDIARG_OPENADAPTER 结构 (d3dumddi.h)

D3DDDIARG_OPENADAPTER结构包含描述图形适配器对象的信息。

语法

typedef struct _D3DDDIARG_OPENADAPTER {
  [in/out] HANDLE                        hAdapter;
  [in]     UINT                          Interface;
  [in]     UINT                          Version;
  [in]     const D3DDDI_ADAPTERCALLBACKS *pAdapterCallbacks;
  [out]    D3DDDI_ADAPTERFUNCS           *pAdapterFuncs;
  [out]    UINT                          DriverVersion;
} D3DDDIARG_OPENADAPTER;

成员

[in/out] hAdapter

图形适配器对象的句柄。 输入 OpenAdapter 函数时， hAdapter 指定在驱动程序调用 Microsoft Direct3D 运行时提供的 pfnQueryAdapterInfoCb 回调函数时驱动程序查询图形适配器功能的句柄。

驱动程序生成唯一句柄，并将其传递回 Direct3D 运行时。 在 OpenAdapter 函数的输出中， hAdapter 指定 Direct3D 运行时在后续驱动程序调用中用于标识图形适配器对象的句柄。

[in] Interface

Direct3D/DirectDraw 接口版本 (打开图形适配器的 7、8 或 9) 。

[in] Version

驱动程序可用于标识 Direct3D/DirectDraw 运行时生成时间的数字。 例如，驱动程序可以使用版本号来区分随 Windows Vista 发布的运行时和使用后续 Service Pack 发布的运行时，后者可能包含驱动程序所需的修补程序。

[in] pAdapterCallbacks

指向 D3DDDI_ADAPTERCALLBACKS 结构的指针，该结构包含驱动程序可以使用的 Direct3D 运行时提供的 pfnQueryAdapterInfoCb 回调函数。

[out] pAdapterFuncs

指向 D3DDDI_ADAPTERFUNCS 结构的指针，该结构包含特定于用户模式显示驱动程序适配器的函数表。 Direct3D 运行时使用这些函数与用户模式显示驱动程序就特定于图形适配器的操作进行通信。

[out] DriverVersion

Direct3D 用户模式显示驱动程序接口的版本，该接口是从编译驱动程序时使用的 D3dumddi.h 头文件获取的。 用户模式显示驱动程序应返回D3D_UMD_INTERFACE_VERSION。

注意 如果用户模式驱动程序不支持 windows 7 功能 (DXGKDDI_INTERFACE_VERSION < DXGKDDI_INTERFACE_VERSION_WIN7) ，并且你想要使用 Windows 7 WDK (版本 7600) 编译驱动程序，请确保驱动程序返回D3D_UMD_INTERFACE_VERSION_VISTA。

 

要求

要求	值
最低受支持的客户端	在 Windows Vista 和更高版本的 Windows 操作系统中可用。
标头	d3dumddi.h (包括 D3dumddi.h)

另请参阅

D3DDDI_ADAPTERCALLBACKS

D3DDDI_ADAPTERFUNCS

OpenAdapter

pfnQueryAdapterInfoCb