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 |