Freigeben über


IDirectDrawPalette::GetEntries-Methode (ddraw.h)

Ruft Palettenwerte aus einem DirectDrawPalette-Objekt ab.

Syntax

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

Parameter

[in] unnamedParam1

Derzeit nicht verwendet und muss auf 0 festgelegt werden.

[in] unnamedParam2

Der Start der abzurufenden Einträge erfolgt sequenziell.

[in] unnamedParam3

Anzahl der Paletteneinträge, die in das Array passen können, das lpEntries angibt. Die Farben der Paletteneinträge werden nacheinander zurückgegeben, vom Wert des dwStartingEntry-Parameters bis zum Wert des dwCount-Parameters minus 1. (Diese Parameter werden von IDirectDrawPalette::SetEntries festgelegt.)

[out] unnamedParam4

Ein Array von PALETTEENTRY-Strukturen , das die Paletteneinträge vom DirectDrawPalette-Objekt empfängt. Die Paletteneinträge sind jeweils 1 Byte, wenn das flag DDPCAPS_8BITENTRIES festgelegt ist, andernfalls 4 Bytes. Jedes Feld ist eine Farbbeschreibung.

Rückgabewert

Wenn die Methode erfolgreich ist, wird der Rückgabewert DD_OK.

Wenn ein Fehler auftritt, kann die Methode einen der folgenden Fehlerwerte zurückgeben:

  • DDERR_INVALIDOBJECT
  • DDERR_INVALIDPARAMS
  • DDERR_NOTPALETTIZED

Anforderungen

Anforderung Wert
Zielplattform Windows
Kopfzeile ddraw.h
Bibliothek Ddraw.lib
DLL Ddraw.dll

Weitere Informationen

IDirectDrawPalette