GetColorProfileFromHandle 関数 (icm.h)
開いているカラー プロファイルへのハンドルを指定すると、 GetColorProfileFromHandle 関数は、プロファイルの内容をアプリケーションによって提供されるバッファーにコピーします。 ハンドルが Windows カラー システム (WCS) ハンドルの場合、DMP が返され、HPROFILE に関連付けられている CAMP および GMMP は無視されます。
構文
BOOL GetColorProfileFromHandle(
HPROFILE hProfile,
PBYTE pProfile,
PDWORD pcbProfile
);
パラメーター
hProfile
開いている色プロファイルにハンドルします。 この関数は、HPROFILE に ICC プロファイル情報と WCS プロファイル情報のどちらを含めるかを判別します。
pProfile
生の ICC または DMP プロファイル データを受信するためのバッファーへのポインター。 NULL を指定できます。 その場合、バッファーに必要なサイズは 、pcbSize が指すメモリ位置に格納されます。 バッファーは適切なサイズに割り当てることができ、この関数はバッファーのアドレスを含む pBuffer で再度呼び出されます。
pcbProfile
pBuffer が指すバッファーのサイズを保持する DWORD へのポインター。 戻り値には、関数が成功した場合に実際に使用されたバッファーのサイズが格納されます。 この関数が pBuffer を NULL に設定して呼び出された場合、このパラメーターには必要なバッファーのサイズが含まれます。
戻り値
この関数が成功した場合、戻り値は TRUE になります。 pBuffer パラメーターが NULL で、バッファーに必要なサイズが pcbSize にコピーされる場合は FALSE を返します。
この関数が失敗した場合、戻り値は FALSE になります。 拡張エラー情報については、 GetLastError を呼び出します。
要件
サポートされている最小のクライアント | Windows 2000 Professional [デスクトップ アプリのみ] |
サポートされている最小のサーバー | Windows 2000 Server [デスクトップ アプリのみ] |
Header | icm.h |
Library | Mscms.lib |
[DLL] | Mscms.dll |