IDirectDraw7::GetCaps method (ddraw.h)

Retrieves the capabilities of the device driver for the hardware and the hardware emulation layer (HEL).

Syntax

HRESULT GetCaps(
  [out] LPDDCAPS unnamedParam1,
  [out] LPDDCAPS unnamedParam2
);

Parameters

[out] unnamedParam1

A pointer to a DDCAPS structure that receives the capabilities of the hardware, as reported by the device driver. Set this parameter to NULL if you do not want to retrieve device driver capabilities.

[out] unnamedParam2

A pointer to a DDCAPS structure that receives the capabilities of the HEL. Set this parameter to NULL if you do not want to retrieve HEL capabilities.

Return value

If the method succeeds, the return value is DD_OK.

If it fails, the method can return one of the following error values:

  • DDERR_INVALIDOBJECT
  • DDERR_INVALIDPARAMS
You can set only one of the two parameters to NULL to exclude it. If you set both to NULL, the method fails and returns DDERR_INVALIDPARAMS.

Requirements

Requirement Value
Target Platform Windows
Header ddraw.h
Library Ddraw.lib
DLL Ddraw.dll

See also

IDirectDraw7