IDirectDrawSurface7::SetColorKey メソッド (ddraw.h)
ハードウェアがサーフェスごとにカラー キーをサポートしている場合は、DirectDrawSurface オブジェクトのカラー キー値を設定します。
構文
HRESULT SetColorKey(
[in] DWORD unnamedParam1,
[in] LPDDCOLORKEY unnamedParam2
);
パラメーター
[in] unnamedParam1
要求されたカラー キーを指定するために、次のいずれかのフラグに設定できる値。
DDCKEY_COLORSPACE
構造体には色空間が含まれています。 構造体に単一の色のキーが含まれている場合は設定されません。
DDCKEY_DESTBLT
ビット ブロック転送 (bitblt) 操作の宛先カラー キーとして使用するカラー キーまたは色空間。
DDCKEY_DESTOVERLAY
オーバーレイ操作の宛先カラー キーとして使用するカラー キーまたは色空間。
DDCKEY_SRCBLT
ビットblt 操作のソース カラー キーとして使用するカラー キーまたは色空間。
DDCKEY_SRCOVERLAY
オーバーレイ操作のソース カラー キーとして使用するカラー キーまたは色空間。
[in] unnamedParam2
DirectDrawSurface オブジェクトの新しいカラー キー値を含む DDCOLORKEY 構造体へのポインター。 以前に設定したカラー キーを削除するには、この値を NULL にできます。
戻り値
メソッドが成功した場合、戻り値はDD_OK。
失敗した場合、メソッドは次のいずれかのエラー値を返すことができます。
- DDERR_GENERIC
- DDERR_INVALIDOBJECT
- DDERR_INVALIDPARAMS
- DDERR_INVALIDSURFACETYPE
- DDERR_NOOVERLAYHW
- DDERR_NOTAOVERLAYSURFACE
- DDERR_SURFACELOST
- DDERR_UNSUPPORTED
- DDERR_WASSTILLDRAWING
注釈
透明なビットブレット操作とオーバーレイの場合は、変換先サーフェスに変換先の色を設定し、ソース サーフェスのソースカラーを設定します。
要件
| 要件 | 値 |
|---|---|
| 対象プラットフォーム | Windows |
| ヘッダー | ddraw.h |
| Library | Ddraw.lib |
| [DLL] | Ddraw.dll |