IDirectDrawSurface7::GetCaps method

Retrieves the capabilities of this surface. These capabilities are not necessarily related to the capabilities of the display device.

Syntax


HRESULT GetCaps(
  [in] LPDDSCAPS2 lpDDSCaps
);

Parameters

lpDDSCaps [in]

A pointer to a DDSCAPS2 structure that receives the hardware capabilities of this surface.

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

Remarks

The IDirectDrawSurface7::GetCaps method differs from its counterpart in the IDirectDrawSurface3 interface in that it accepts a pointer to a DDSCAPS2 structure, rather than the legacy DDSCAPS structure.

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

IDirectDrawSurface7

 

 

Show: