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 user-mode display driver (UMD) should use to query for graphics adapter capabilities when the driver calls the Direct3D runtime-supplied pfnQueryAdapterInfoCb callback function.
The UMD 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, 9, 10, 11, 12) 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 callback functions that the driver can use, including:
[out] pAdapterFuncs
A pointer to a D3DDDI_ADAPTERFUNCS structure that contains a table of UMD adapter-specific functions. The Direct3D runtime uses these functions to communicate with the UMD about operations that are specific to the graphics adapter.
[out] DriverVersion
The version of the Direct3D UMD's interface, which was obtained from the D3dumddi.h header file, that the driver was compiled with. The UMD should return D3D_UMD_INTERFACE_VERSION.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Windows Vista (WDDM 1.0) |
| Header | d3dumddi.h (include D3dumddi.h) |