getColorProfileFromHandle 函式 (icm.h)
給定開啟色彩設定檔的控制碼, GetColorProfileFromHandle 函式會將設定檔的內容複寫到應用程式提供的緩衝區。 如果控制碼是 Windows Color System (WCS) 控制碼,則會傳回 DMP,並忽略與 HPROFILE 相關聯的 CAMP 和 GMMP。
語法
BOOL GetColorProfileFromHandle(
HPROFILE hProfile,
PBYTE pProfile,
PDWORD pcbProfile
);
參數
hProfile
開啟色彩設定檔的控制碼。 函式會判斷 HPROFILE 是否包含 ICC 或 WCS 設定檔資訊。
pProfile
緩衝區的指標,用來接收原始的 ICC 或 DMP 設定檔資料。 可以是 Null。 如果是,緩衝區所需的大小將會儲存在 由其所指向的記憶體位置中。 緩衝區可以配置給適當的大小,而且此函式會再次呼叫,並包含緩衝區位址的 pBuffer 呼叫。
pcbProfile
保留pBuffer所指向之緩衝區大小的DWORD指標。 傳回時,它會填入在函式成功時實際使用的緩衝區大小。 如果呼叫此函式並將 pBuffer 設定為 Null,此參數將包含所需的緩衝區大小。
傳回值
如果此函式成功,則傳回值為 TRUE。 如果pBuffer參數為Null,而且緩衝區所需的大小會複製到其上,則會傳回FALSE。
如果此函式失敗,則傳回值為 FALSE。 如需擴充的錯誤資訊,請呼叫 GetLastError。
需求
最低支援的用戶端 | Windows 2000 Professional [僅限傳統型應用程式] |
最低支援的伺服器 | Windows 2000 Server [僅限桌面應用程式] |
標頭 | icm.h |
程式庫 | Mscms.lib |
Dll | Mscms.dll |