CMCreateProfileW 函式 （icm.h）

[CMCreateProfileW 從 Windows Vista 開始不再可用。

從 LOGCOLORSPACEW 結構建立顯示色彩設定檔。

語法

BOOL CMCreateProfileW(
  LPLOGCOLORSPACEW 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 不支援 CMCreateProfileW，Windows 會使用預設 CMM 來建立配置檔。

CMM 應將所有標頭欄位設定為合理的預設值。 此設定檔應該可作為轉換中的輸入設定檔使用。

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

需求

另請參閱

• 基本色彩管理概念
• 函數