IDirectDrawPalette::SetEntries method (ddraw.h)

Changes entries in a DirectDrawPalette object immediately.

Syntax

HRESULT SetEntries(
  [in] DWORD          unnamedParam1,
  [in] DWORD          unnamedParam2,
  [in] DWORD          unnamedParam3,
  [in] LPPALETTEENTRY unnamedParam4
);

Parameters

[in] unnamedParam1

Currently not used and must be set to 0.

[in] unnamedParam2

First entry to be set.

[in] unnamedParam3

Number of palette entries to be changed.

[in] unnamedParam4

An array of PALETTEENTRY structures that contains the palette entries that SetEntries uses to change the DirectDrawPalette object. The palette entries are 1 byte each if the DDPCAPS_8BITENTRIES flag is set, and 4 bytes otherwise. Each field is a color description.

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
  • DDERR_NOPALETTEATTACHED
  • DDERR_NOTPALETTIZED
  • DDERR_UNSUPPORTED

Requirements

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

See also

IDirectDrawPalette