IDirectDraw7::CreatePalette メソッド (ddraw.h)
この DirectDraw オブジェクトの DirectDrawPalette オブジェクトを作成します。
構文
HRESULT CreatePalette(
[in] DWORD unnamedParam1,
[in] LPPALETTEENTRY unnamedParam2,
[out] LPDIRECTDRAWPALETTE *unnamedParam3,
[in] IUnknown *unnamedParam4
);
パラメーター
[in] unnamedParam1
この値は、次のフラグの 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 メンバーは、1 つの 8 ビットアルファ値 (peRed、peGreen、および peBlue メンバーに加えて) として解釈されます。 このフラグを使用して作成されたパレットは、テクスチャ(DDSCAPS_TEXTURE機能フラグを使用して作成されたサーフェス)にのみアタッチできます。
DDPCAPS_ALLOW256
このパレットには、256 個のエントリをすべて定義できます。
DDPCAPS_INITIALIZE
互換性のために残されています。 DirectDraw は常に 、lpDDColorArray で渡されるカラー配列の色を使用して、このパレットを初期化します。
DDPCAPS_PRIMARYSURFACE
このパレットは、プライマリ サーフェスにアタッチされます。 このパレットのカラーテーブルを変更すると、DDPSETPAL_VSYNCが指定され、サポートされていない限り、表示に直ちに影響します。
DDPCAPS_PRIMARYSURFACELEFT
このパレットは、左目のプライマリ サーフェスにアタッチされたパレットです。 このパレットのカラー テーブルを変更すると、DDPSETPAL_VSYNCが指定され、サポートされていない限り、左目の表示にすぐに影響します。
DDPCAPS_VSYNC
このパレットは、モニターのリフレッシュレートと同期された変更を加えることができます。
[in] unnamedParam2
DirectDrawPalette オブジェクトを初期化するための 2、4、16、または 256 の PALETTEENTRY 構造体の配列のアドレス。
[out] unnamedParam3
呼び出しが成功した場合に有効な IDirectDrawPalette インターフェイス ポインターに設定される変数のアドレス。
[in] unnamedParam4
COM 集計機能との将来の互換性を確保します。 現在、このパラメーターが NULL でない場合、このメソッドはエラーを返します。
戻り値
メソッドが成功した場合、戻り値はDD_OK。
失敗した場合、メソッドは次のいずれかのエラー値を返すことができます。
- DDERR_INVALIDOBJECT
- DDERR_INVALIDPARAMS
- DDERR_NOCOOPERATIVELEVELSET
- DDERR_OUTOFMEMORY
- DDERR_UNSUPPORTED
要件
要件 | 値 |
---|---|
対象プラットフォーム | Windows |
ヘッダー | ddraw.h |
Library | Ddraw.lib |
[DLL] | Ddraw.dll |