DirectX SDK

IDirectDrawPalette::GetCaps

The IDirectDrawPalette::GetCaps method retrieves the capabilities of this palette object.

HRESULT GetCaps(
  LPDWORD lpdwCaps  
);

Parameters

lpdwCaps

One of the following flags from the dwPalCaps member of the DDCAPS structure that defines palette capabilities:

DDPCAPS_1BIT

DDPCAPS_2BIT

DDPCAPS_4BIT

DDPCAPS_8BIT

DDPCAPS_8BITENTRIES

DDPCAPS_ALPHA

DDPCAPS_ALLOW256

DDPCAPS_PRIMARYSURFACE

DDPCAPS_PRIMARYSURFACELEFT

DDPCAPS_VSYNC

Return Values

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

Requirements

  Windows NT/2000: Requires Windows NT 4.0 SP3 or later.
  Windows 95/98: Requires Windows 95 or later. Available as a redistributable for Windows 95.
  Header: Declared in ddraw.h.
  Import Library: Use ddraw.lib.