CMCreateProfile 函式 (icm.h)

[CMCreateProfile 已不再可供 Windows Vista 使用。]

從 LOGCOLORSPACEA 結構建立顯示色彩配置檔。

語法

BOOL CMCreateProfile(
  LPLOGCOLORSPACEA lpColorSpace,
  LPDEVCHARACTER   *lpProfileData
);

lpColorSpace

色彩邏輯空間的指標，其中 lcsFilename 成員會是 NULL。

lpProfileData

緩衝區指標的指標。如果成功，函式會配置並填滿此緩衝區。呼叫端應用程式必須負責在不再需要時釋放此緩衝區。

從 Windows Vista 開始，預設的 CMM (Icm32.dll) 會傳回 FALSE ，而 GetLastError 會回報ERROR_NOT_SUPPORTED。

Windows Server 2003、Windows XP 和 Windows 2000：

如果此函式成功，則傳回值為 TRUE。

如果此函式失敗，則傳回值為 FALSE。呼叫 GetLastError 以擷取錯誤。

從 Windows Vista 開始，不再需要 CMM 實作器來實作此方法。

Windows Server 2003、Windows XP 和 Windows 2000：

此函式的 Unicode 版本為 CMCreateProfileW。

只有 Windows 預設 CMM 才能匯出此函式;這是所有其他 CMM 的選擇性專案。

如果 CMM 不支援 CMCreateProfile，Windows 會使用預設 CMM 來建立配置檔。

CMM 應將所有標頭字段設定為合理的預設值。這個設定檔應該可作為轉換中的輸入配置檔。

呼叫的應用程式必須釋放這個函式所配置的緩衝區，並由 lpProfileData 參數指向。使用 GlobalFree 釋放緩衝區。