IDirectDrawPalette::GetEntries

This method queries palette values from a DirectDrawPalette object.

HRESULT GetEntries(
  DWORD dwFlags, 
  DWORD dwBase, 
  DWORD dwNumEntries, 
  LPPALETTEENTRY lpEntries
); 

Parameters

• dwFlags
  This parameter is currently not used and must be set to zero.
• dwBase
  Start of the entries that should be retrieved sequentially.
• dwNumEntries
  Number of palette entries that can fit in the address specified in lpEntries. The colors of each palette entry are returned in sequence, from the value of the dwStartingEntry parameter through the value of the dwCount parameter minus 1. These parameters are set by IDirectDrawPalette::SetEntries.
• lpEntries
  Address of the palette entries. The palette entries are one byte each if the DDPCAPS_8BITENTRIES flag is set and four bytes otherwise. Each field is a color description.

Return Values

If the method succeeds, the return value is DD_OK.

If the method fails, the return value may be one of the following error values:

Requirements

OS Versions: Windows CE 2.12 and later. Version 2.12 requires DXPAK 1.0 or later.
Header: Ddraw.h.
Link Library: Ddraw.lib.

See Also

IDirectDrawPalette::SetEntries

 Last updated on Thursday, April 08, 2004

© 1992-2003 Microsoft Corporation. All rights reserved.