D3DDDIARG_OPENADAPTER structure (d3dumddi.h)

The D3DDDIARG_OPENADAPTER structure contains information that describes the graphics adapter object.

Syntax

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;

Members

[in/out] hAdapter

A handle to the graphics adapter object. On input to the OpenAdapter function, hAdapter specifies the handle that the driver should use to query for graphics adapter capabilities when the driver calls the Microsoft Direct3D runtime-supplied pfnQueryAdapterInfoCb callback function.

The driver generates a unique handle and passes it back to the Direct3D runtime. On output from the OpenAdapter function, hAdapter specifies the handle that the Direct3D runtime uses in subsequent driver calls to identify the graphics adapter object.

[in] Interface

The Direct3D/DirectDraw interface version (for example, 7, 8, or 9) that opens the graphics adapter.

[in] Version

A number that the driver can use to identify when the Direct3D/DirectDraw runtime was built. For example, the driver can use the version number to differentiate between a runtime that is released with Windows Vista and a runtime that is released with a subsequent service pack, which might contain a fix that the driver requires.

[in] pAdapterCallbacks

A pointer to a D3DDDI_ADAPTERCALLBACKS structure that contains the Direct3D runtime-supplied pfnQueryAdapterInfoCb callback function that the driver can use.

[out] pAdapterFuncs

A pointer to a D3DDDI_ADAPTERFUNCS structure that contains a table of user-mode display driver adapter-specific functions. The Direct3D runtime uses these functions to communicate with the user-mode display driver about operations that are specific to the graphics adapter.

[out] DriverVersion

The version of the Direct3D user-mode display driver's interface, which was obtained from the D3dumddi.h header file, that the driver was compiled with. The user-mode display driver should return D3D_UMD_INTERFACE_VERSION.

Note  If a user-mode driver does not support Windows 7 features (DXGKDDI_INTERFACE_VERSION < DXGKDDI_INTERFACE_VERSION_WIN7), and you want to compile the driver with the Windows 7 WDK (Version 7600), make sure that the driver returns D3D_UMD_INTERFACE_VERSION_VISTA.

 

Requirements

Requirement	Value
Minimum supported client	Available in Windows Vista and later versions of the Windows operating systems.
Header	d3dumddi.h (include D3dumddi.h)

See also

D3DDDI_ADAPTERCALLBACKS

D3DDDI_ADAPTERFUNCS

OpenAdapter

pfnQueryAdapterInfoCb