D3DKMTOpenAdapterFromDeviceName function

The D3DKMTOpenAdapterFromDeviceName function maps a device name to a graphics adapter handle and, if the adapter contains multiple monitor outputs, to one of those outputs.


NTSTATUS D3DKMTOpenAdapterFromDeviceName(



pData [in, out]

A pointer to a D3DKMT_OPENADAPTERFROMDEVICENAME structure that describes the parameters that are required to perform the mapping.

Return Value

D3DKMTOpenAdapterFromDeviceName returns one of the following values:

Return code Description
STATUS_SUCCESS The mapping was performed successfully.
STATUS_INVALID_PARAMETER Parameters were validated and determined to be incorrect or the Windows Vista display driver model was not used.

This function might also return other NTSTATUS values.


A graphics adapter corresponds to a video card. A monitor output corresponds to a head on a video card. A system with a single video card contains only one adapter. However, if the video card supports multiple heads, it supports outputting to multiple monitors.


Minimum supported client Available in Windows Vista and later versions of the Windows operating systems.
Target Platform Universal
Header d3dkmthk.h (include D3dkmthk.h)
Library Gdi32.lib
DLL Gdi32.dll

See Also