Platform SDK: DirectX

IDirectDrawPalette::SetEntries

The IDirectDrawPalette::SetEntries method changes entries in a DirectDrawPalette object immediately.

HRESULT SetEntries(
  DWORD dwFlags,          
  DWORD dwStartingEntry,  
  DWORD dwCount,          
  LPPALETTEENTRY lpEntries  
);

Parameters

dwFlags
Currently not used and must be set to 0.
dwStartingEntry
First entry to be set.
dwCount
Number of palette entries to be changed.
lpEntries
Address of the palette entries. 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 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
DDERR_NOPALETTEATTACHED
DDERR_NOTPALETTIZED
DDERR_UNSUPPORTED

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.

See Also

IDirectDrawPalette::GetEntries, IDirectDrawSurface7::SetPalette