IDirectDrawSurface7：：SetColorKey 方法 (ddraw.h)
如果硬體支援每個表面的色彩索引鍵，請設定 DirectDrawSurface 物件的色彩索引鍵值。
語法
HRESULT SetColorKey(
[in] DWORD unnamedParam1,
[in] LPDDCOLORKEY unnamedParam2
);
參數
[in] unnamedParam1
值，可設定為下列其中一個旗標，以指定要求的色彩索引鍵：
DDCKEY_COLORSPACE
結構包含色彩空間。 如果結構包含單一色彩索引鍵，則不會設定。
DDCKEY_DESTBLT
要作為位區塊傳輸目的地色彩索引鍵的色彩索引鍵或色彩空間， (bitblt) 作業。
DDCKEY_DESTOVERLAY
要作為重疊作業之目的地色彩索引鍵的色彩索引鍵或色彩空間。
DDCKEY_SRCBLT
要作為 bitblt 作業之來源色彩索引鍵的色彩索引鍵或色彩空間。
DDCKEY_SRCOVERLAY
要作為重疊作業來源色彩索引鍵的色彩索引鍵或色彩空間。
[in] unnamedParam2
DDCOLORKEY 結構的指標，其中包含 DirectDrawSurface 物件的新色彩索引鍵值。 此值可以是NULL，可移除先前設定的色彩索引鍵。
傳回值
如果方法成功，傳回值會DD_OK。
如果失敗，方法可以傳回下列其中一個錯誤值：
- DDERR_GENERIC
- DDERR_INVALIDOBJECT
- DDERR_INVALIDPARAMS
- DDERR_INVALIDSURFACETYPE
- DDERR_NOOVERLAYHW
- DDERR_NOTAOVERLAYSURFACE
- DDERR_SURFACELOST
- DDERR_UNSUPPORTED
- DDERR_WASSTILLDRAWING
備註
針對透明 bitblt 作業和重疊，請在目的地介面上設定目的地色彩，並在來源介面上設定來源色彩。
規格需求
| 需求 | 值 |
|---|---|
| 目標平台 | Windows |
| 標頭 | ddraw.h |
| 程式庫 | Ddraw.lib |
| Dll | Ddraw.dll |