Microsoft DirectX 8.0 (C++)

IDirect3D8::GetAdapterDisplayMode

Retrieves the current display mode of the adapter.

HRESULT GetAdapterDisplayMode(
  UINT Adapter,
  D3DDISPLAYMODE* pMode
);

Parameters

Adapter
[in] Ordinal number that denotes the display adapter to query. D3DADAPTER_DEFAULT is always the primary display adapter.
pMode
[in, out] Pointer to a D3DDISPLAYMODE structure, to be filled with information describing the current adapter's mode.

Return Values

If the method succeeds, the return value is D3D_OK.

If Adapter is out of range or pMode is invalid, this method returns D3DERR_INVALIDCALL.

Remarks

Note that a device that represents an adapter may have been reset into a particular mode, but this may not be the actual mode of the adapter. A device reset to a particular mode may be lost, and therefore it can not determine the current mode of the adapter. This function returns the adapter mode, not any particular device's desired mode.

Requirements

  Header: Declared in D3d8.h.
  Import Library: Use D3d8.lib.