共用方式為

GetColorProfileElement 函式 (icm.h)

  • 發行項

將資料從指定之色彩設定檔的指定標記設定檔元素複製到緩衝區。

語法

BOOL GetColorProfileElement(
  HPROFILE hProfile,
  TAGTYPE  tag,
  DWORD    dwOffset,
  PDWORD   pcbElement,
  PVOID    pElement,
  PBOOL    pbReference
);

參數

hProfile

指定有問題的國際色彩聯盟 (ICC) 色彩設定檔的控制碼。

tag

識別要從中複製的標記專案。

dwOffset

指定要開始複製之標記專案資料的第一個位元組的位移。

pcbElement

指定要複製位元組數目的變數指標。 傳回時，變數包含實際複製的位元組數目。

pElement

要複製標記之專案資料的緩衝區指標。 緩衝區必須至少包含 由由其所指向的變數所指定的位元組數目。」 如果 pBuffer 指標設定為 Null，則會在以位元組為單位的整個標記元素資料大小傳回于 由 lbSize 所指向的記憶體位置，並忽略 dwOffset 。 在此情況下，函式會傳回 FALSE。

pbReference

指向布林值，如果色彩設定檔中有一個以上的標籤參考指定標籤所參考的資料，則指向設定為 TRUE 的布林值，否則為 FALSE 。

傳回值

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

如果此函式失敗，則傳回值為 FALSE。 如需擴充錯誤資訊，請呼叫 GetLastError。

備註

如果 hProfile 不是有效的國際色彩聯盟 () 設定檔，此函式將會失敗。

如果 pBuffer 指標設定為 Null，則會在以 mb 為單位的變數中傳回整個標記元素資料的大小 ， 並忽略 dwOffset 。

此函式不支援 Windows 色彩系統 (WCS) 設定檔 CAMP、DMP 和 GMMP;因為設定檔元素會隱含地關聯，而且硬式編碼至，所以有許多強固的 XML 剖析程式庫。

需求

   
最低支援的用戶端 Windows 2000 專業版 [僅限傳統型應用程式]
最低支援的伺服器 Windows 2000 Server [僅限傳統型應用程式]
標頭 icm.h
程式庫 Mscms.lib
Dll Mscms.dll

另請參閱