createDeviceLinkProfile 函式 (icm.h)
使用指定的意圖,從一組色彩設定檔建立國際色彩聯盟 (ICC) 裝置連結設定檔 。
語法
BOOL CreateDeviceLinkProfile(
PHPROFILE hProfile,
DWORD nProfiles,
PDWORD padwIntent,
DWORD nIntents,
DWORD dwFlags,
PBYTE *pProfileData,
DWORD indexPreferredCMM
);
參數
hProfile
要使用的色彩設定檔控制碼陣列的指標。 函式會判斷 HPROFILEs 是否包含 ICC 設定檔資訊,如果是的話,它會適當地處理它們。
nProfiles
指定 hProfile所指向陣列中的設定檔數目。
padwIntent
DWORDS陣列的指標,其中包含要使用的意圖。 請參閱 轉譯意圖。
nIntents
padwIntent所指向陣列中的意圖數目。
dwFlags
指定旗標,用來控制轉換的建立。 如需詳細資訊,請參閱 CMM 轉換建立旗標。
pProfileData
緩衝區指標的指標。 如果成功,此函式會配置緩衝區、將其位址放在 *pProfileData中,並以裝置連結設定檔填滿它。 如果函式成功,呼叫的應用程式必須在不再需要緩衝區之後釋放緩衝區。
indexPreferredCMM
指定色彩設定檔的一個基底索引,指出要使用的色彩管理模組 (CMM) 。 應用程式開發人員可藉由將此參數設定為 INDEX_DONT_CARE,讓 Windows 選擇 CMM。 請參閱 使用色彩管理模組 (CMM) 。
傳回值
如果此函式成功,則傳回值為非零值。
如果此函式失敗,則傳回值為零。 如需擴充的錯誤資訊,請呼叫 GetLastError。
備註
針對包含 WCS 設定檔資訊的 HPROFIES,HPROFIES 會轉換成有效的 ICC 設定檔控制碼,然後在建立裝置連結設定檔時使用這些 ICC 設定檔控制碼。
陣列中的第一個和最後一個設定檔必須是裝置設定檔。 其他設定檔可以是色彩空間或抽象設定檔。
每個設定檔的輸出色彩空間都必須是下一個設定檔的輸入色彩空間。
呼叫的應用程式必須釋放此函式所配置的緩衝區,並由 pProfileData 參數指向。 GlobalFree函式應該用來釋放緩衝區。
需求
最低支援的用戶端 | Windows 2000 Professional [僅限傳統型應用程式] |
最低支援的伺服器 | Windows 2000 Server [僅限桌面應用程式] |
標頭 | icm.h |
程式庫 | Mscms.lib |
Dll | Mscms.dll |