IDirectDrawPalette::GetCaps メソッド (ddraw.h)
パレット オブジェクトの機能を取得します。
構文
HRESULT GetCaps(
[out] LPDWORD unnamedParam1
);
パラメーター
[out] unnamedParam1
パレット機能を定義する DDCAPS 構造体の dwPalCaps メンバーから値を受け取る変数へのポインター。 この値は、次のフラグの 1 つ以上で構成されます。
DDPCAPS_1BIT
インデックスは 1 ビットです。 カラー テーブルには 2 つのエントリがあります。
DDPCAPS_2BIT
インデックスは 2 ビットです。 カラー テーブルには 4 つのエントリがあります。
DDPCAPS_4BIT
インデックスは 4 ビットです。 カラー テーブルには 16 個のエントリがあります。
DDPCAPS_8BIT
インデックスは 8 ビットです。 カラー テーブルには 256 個のエントリがあります。
DDPCAPS_8BITENTRIES
インデックスは、8 ビットのカラー インデックスを参照します。 このフラグは、DDPCAPS_1BIT、DDPCAPS_2BIT、または DDPCAPS_4BIT フラグと共に使用され、ターゲット サーフェスが 8 bpp の場合にのみ有効です。 各カラー エントリは 1 バイトの長さであり、宛先サーフェスの 8-bpp パレットのインデックスです。
DDPCAPS_ALPHA
関連する PALETTEENTRY 構造体の peFlags メンバーは、(peRed、peGreen、および peBlue メンバーに加えて) 単一の 8 ビットアルファ値として解釈する必要があります。 このフラグを使用して作成されたパレットは、テクスチャ (DDSCAPS_TEXTURE機能フラグを使用して作成されたサーフェス) にのみアタッチできます。
DDPCAPS_ALLOW256
このパレットには、256 個のエントリをすべて定義できます。
DDPCAPS_PRIMARYSURFACE
このパレットは、プライマリ サーフェスにアタッチされます。 このパレットのカラーテーブルを変更すると、DDPSETPAL_VSYNCが指定され、サポートされていない限り、表示に直ちに影響します。
DDPCAPS_PRIMARYSURFACELEFT
このパレットは、左目のプライマリ サーフェスにアタッチされているパレットです。 このパレットのカラー テーブルを変更すると、DDPSETPAL_VSYNCが指定され、サポートされていない限り、左目の表示にすぐに影響します。
DDPCAPS_VSYNC
このパレットは、モニターのリフレッシュレートと同期された変更を加えることができます。
戻り値
メソッドが成功した場合、戻り値はDD_OK。
失敗した場合、メソッドは次のいずれかのエラー値を返すことができます。
- DDERR_INVALIDOBJECT
- DDERR_INVALIDPARAMS
要件
| 要件 | 値 |
|---|---|
| 対象プラットフォーム | Windows |
| ヘッダー | ddraw.h |
| Library | Ddraw.lib |
| [DLL] | Ddraw.dll |