IDirectDraw7::GetCaps method

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

Syntax

HRESULT GetCaps(
  LPDDCAPS ,
  LPDDCAPS 
);

Parameters

arg1

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.

arg2

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

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

See Also

IDirectDraw7