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 cannot 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.