PFND3DDDI_OPENADAPTER callback function (d3dumddi.h)
The user-mode display driver's (UMD) OpenAdapter function creates a graphics adapter object that is referenced in subsequent calls.
Syntax
PFND3DDDI_OPENADAPTER Pfnd3dddiOpenadapter;
HRESULT Pfnd3dddiOpenadapter(
D3DDDIARG_OPENADAPTER *unnamedParam1
)
{...}
Parameters
unnamedParam1
[in/out] pOpenData points to a D3DDDIARG_OPENADAPTER structure. On input, this structure contains information that the driver can use. On output, the driver specifies information that the 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 Direct3D runtime can create a display device by calling CreateDevice, the UMD should call the pfnQueryAdapterInfoCb function to query for the graphics hardware capabilities from the kernel-mode display miniport driver (KMD).
The Direct3D runtime can open multiple graphics adapter objects from a single graphics adapter.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Windows Vista (WDDM 1.0) |
| Target Platform | Desktop |
| Header | d3dumddi.h (include D3dumddi.h) |