PFND3DDDI_OPENADAPTER callback function (d3dumddi.h)
The OpenAdapter function creates a graphics adapter object that is referenced in subsequent calls.
Syntax
PFND3DDDI_OPENADAPTER Pfnd3dddiOpenadapter;
HRESULT Pfnd3dddiOpenadapter(
D3DDDIARG_OPENADAPTER *unnamedParam1
)
{...}
Parameters
unnamedParam1
pOpenData [in, out]
A pointer to a D3DDDIARG_OPENADAPTER structure. On input, this structure contains information that the driver can use. On output, the driver specifies information that the Microsoft Direct3D runtime can use.
Return value
OpenAdapter returns one of the following values:
| Return code | Description |
|---|---|
| S_OK | The graphics adapter object is successfully created. |
| E_OUTOFMEMORY | OpenAdapter could not allocate the required memory for it to complete. |
Remarks
The graphics adapter object that is created by OpenAdapter represents the underlying graphics hardware. Before the Microsoft Direct3D runtime can create a display device by calling CreateDevice, the user-mode display driver should call the pfnQueryAdapterInfoCb function to query for the graphics hardware capabilities from the display miniport driver.
The Direct3D runtime can open multiple graphics adapter objects from a single graphics adapter.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Available in Windows Vista and later versions of the Windows operating systems. |
| Target Platform | Desktop |
| Header | d3dumddi.h (include D3dumddi.h) |