Expand Minimize

D3DKMTOpenAdapterFromGdiDisplayName function

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

Syntax


NTSTATUS D3DKMTOpenAdapterFromGdiDisplayName(
  _Inout_  D3DKMT_OPENADAPTERFROMGDIDISPLAYNAME *pData
);

Parameters

pData [in, out]

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

Return value

D3DKMTOpenAdapterFromGdiDisplayName returns one of the following values:

Return codeDescription
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.

Remarks

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.

Requirements

Version

Available in Windows Vista and later versions of the Windows operating systems.

Header

D3dkmthk.h (include D3dkmthk.h)

Library

Gdi32.lib

See also

D3DKMT_OPENADAPTERFROMGDIDISPLAYNAME

 

 

Send comments about this topic to Microsoft

Show:
© 2015 Microsoft