Platform SDK: DirectX

IDirectDrawPalette::GetEntries

IDirectDrawPalette::GetEntries メソッドは、DirectDrawPalette オブジェクトからのパレット値を照会する。

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

パラメータ

dwFlags
現時点では未使用なので 0 を設定しておく。
dwBase
順に取得するエントリの先頭。
dwNumEntries
lpEntries に指定するアドレスに適合するパレット エントリの数。個々のパレット エントリの色は、dwStartingEntry パラメータの値から dwCount パラメータの値をマイナス 1 した値まで、順番に返される。(これらの値は、IDirectDrawPalette::SetEntries で設定される)。
lpEntries
パレット エントリのアドレス。DDPCAPS_8BITENTRIES フラグを設定する場合、パレット エントリは 1 バイトごととなる。それ以外の場合は、4 バイトごととなる。個々のフィールドは、色記述となる。

戻り値

成功すれば、DD_OK を返す。

失敗すれば、以下のエラー値のいずれかを返す。

DDERR_INVALIDOBJECT
DDERR_INVALIDPARAMS
DDERR_NOTPALETTIZED

動作環境

  Windows NT/2000 : Windows NT 4.0 Service Pack 3 またはそれ以降が必要。
  Windows 95/98 : Windows 95 以降が必要。Windows 95 用に再配布可能な形で使用可能。
  ヘッダー : ddraw.h で宣言。
  インポート ライブラリ : ddraw.lib を使用。

参照

IDirectDrawPalette::SetEntries