NtGdiDdSetColorKey 函式

[此函式可能會隨著每個作業系統修訂而變更。請改用 Microsoft DirectDraw 和 Microsoft Direct3DAPIs;這些 API 會隔離應用程式與這類作業系統變更，並隱藏與顯示驅動程式直接互動所涉及的許多其他困難。

設定指定介面的色彩索引鍵值。

語法

DWORD APIENTRY NtGdiDdSetColorKey(
  _In_    HANDLE              hSurface,
  _Inout_ PDD_SETCOLORKEYDATA puSetColorKeyData
);

hSurface [in]: DD_SURFACE_LOCAL結構的指標，描述要與其關聯色彩索引鍵的介面。
puSetColorKeyData [in， out]: DD_SETCOLORKEYDATA結構的指標，其中包含設定指定介面之色彩索引鍵所需的資訊。

NtGdiDdSetColorKey 會傳回下列其中一個回呼代碼。

傳回碼	描述
DDHAL_DRIVER_HANDLED	驅動程式已執行作業，並傳回該作業的有效傳回碼。如果此程式碼DD_OK，DirectDraw 或 Direct3D 會繼續進行函式。否則，DirectDraw 或 Direct3D 會傳回驅動程式所提供的錯誤碼，並中止函式。
DDHAL_DRIVER_NOTHANDLED	驅動程式對於要求的作業沒有批註。如果需要驅動程式實作特定的回呼，DirectDraw 或 Direct3D 會報告錯誤狀況。否則，DirectDraw 或 Direct3D 會處理作業，就像驅動程式回呼尚未藉由執行 DirectDraw 或 Direct3D 裝置獨立實作來定義。

需求	值
最低支援的用戶端	Windows 2000 Professional [僅限傳統型應用程式]
最低支援的伺服器	Windows 2000 Server [僅限桌面應用程式]
標頭	Ntgdi.h