IDirectDraw7::GetCaps method

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

Syntax


HRESULT GetCaps(
  [out] LPDDCAPS lpDDDriverCaps,
  [out] LPDDCAPS lpDDHELCaps
);

Parameters

lpDDDriverCaps [out]

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.

lpDDHELCaps [out]

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.

Remarks

You must use LoadLibrary to explicitly link to Ddraw.dll and then use GetProcAddress to access the GetCaps method.

Requirements

Header

Ddraw.h

Library

Ddraw.lib

DLL

Ddraw.dll

See also

IDirectDraw7

 

 

Show: