IDirectDrawSurface7::GetPalette method (ddraw.h)

Retrieves the DirectDrawPalette object that is associated with this surface, and increments the reference count of the returned palette.

Syntax

HRESULT GetPalette(
  [out] LPDIRECTDRAWPALETTE *unnamedParam1
);

Parameters

[out] unnamedParam1

A pointer to a variable to receive a pointer to the palette object's IDirectDrawPalette interface.

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_GENERIC
  • DDERR_INVALIDOBJECT
  • DDERR_INVALIDPARAMS
  • DDERR_NOEXCLUSIVEMODE
  • DDERR_NOPALETTEATTACHED
  • DDERR_SURFACELOST
  • DDERR_UNSUPPORTED

Requirements

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

See also

IDirectDrawSurface7