次の方法で共有


GetColorProfileElement 関数 (icm.h)

指定したカラー プロファイルの指定されたタグ付きプロファイル要素からバッファーにデータをコピーします。

構文

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

パラメーター

hProfile

対象の国際色コンソーシアム (ICC) カラー プロファイルへのハンドルを指定します。

tag

コピー元のタグ付けされた要素を識別します。

dwOffset

コピーを開始するタグ付き要素データの最初のバイトからのオフセットを指定します。

pcbElement

コピーするバイト数を指定する変数へのポインター。 戻り値の場合、変数には実際にコピーされたバイト数が含まれます。

pElement

タグ付けされた要素データをコピーするバッファーへのポインター。 バッファーには 、pcbSize が指す変数で指定されているバイト数以上を含める必要があります。 pBuffer ポインターが NULL に設定されている場合、タグ付けされた要素データ全体のサイズ (バイト単位) は、pcbSize が指すメモリ位置で返され、dwOffset は無視されます。 この場合、関数は FALSE を返します

pbReference

カラー プロファイル内の複数のタグが指定したタグと同じデータを参照している場合は TRUE に設定され、指定されていない場合は FALSE に設定されるブール値を指します。

戻り値

この関数が成功した場合、戻り値は 0 以外です。

この関数が失敗した場合、戻り値は FALSE になります。 拡張エラー情報については、 GetLastError を呼び出します。

解説

hProfile が有効な国際色コンソーシアム (ICC) プロファイルでない場合、この関数は失敗します。

pBuffer ポインターが NULL に設定されている場合、タグ付けされた要素データ全体のサイズ (バイト単位) が pcbSize が指す変数で返され、dwOffset は無視されます。

この関数は、Windows カラー システム (WCS) プロファイル CAMP、DMP、および GMMP をサポートしていません。プロファイル要素はICCタグ型に暗黙的に関連付けられてハードコーディングされ、堅牢な XML 解析ライブラリが多数存在するためです。

要件

   
サポートされている最小のクライアント Windows 2000 Professional [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows 2000 Server [デスクトップ アプリのみ]
Header icm.h
Library Mscms.lib
[DLL] Mscms.dll

関連項目