共用方式為


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

另請參閱