CreateDeviceLinkProfile 関数 (icm.h)
指定した意図を使用して、一連のカラー プロファイルから国際色コンソーシアム (ICC) デバイス リンク プロファイルを作成します。
構文
BOOL CreateDeviceLinkProfile(
PHPROFILE hProfile,
DWORD nProfiles,
PDWORD padwIntent,
DWORD nIntents,
DWORD dwFlags,
PBYTE *pProfileData,
DWORD indexPreferredCMM
);
パラメーター
hProfile
使用するカラー プロファイルのハンドルの配列へのポインター。 この関数は、HPROFILEs に ICC プロファイル情報が含まれているかどうかを判別し、含まれている場合は適切に処理します。
nProfiles
hProfile が指す配列内のプロファイルの数を指定します。
padwIntent
使用する意図を含む DWORDS の配列へのポインター。 「 意図のレンダリング」を参照してください。
nIntents
padwIntent が指す配列内の意図の数。
dwFlags
変換のコントロール作成に使用するフラグを指定します。 詳細については、「 CMM 変換作成フラグ」を参照してください。
pProfileData
バッファーへのポインターへのポインター。 成功した場合、この関数はバッファーを割り当て、そのアドレスを *pProfileData に配置し、デバイス リンク プロファイルで埋めます。 関数が成功した場合、呼び出し元のアプリケーションは、不要になったバッファーを解放する必要があります。
indexPreferredCMM
使用するカラー管理モジュール (CMM) を示すカラー プロファイルの 1 から始まるインデックスを指定します。 アプリケーション開発者は、このパラメーターを INDEX_DONT_CARE に設定することで、Windows で CMM を選択できます。 「カラー管理モジュール (CMM) の使用」を参照してください。
戻り値
この関数が成功した場合、戻り値は 0 以外の値になります。
この関数が失敗した場合、戻り値は 0 です。 拡張エラー情報については、GetLastError を呼び出します。
解説
WCS プロファイル情報を含む HPROFILEs の場合、HPROFILEs は有効な ICC プロファイル・ハンドルに変換され、これらの ICC プロファイル・ハンドルは装置リンク・プロファイルの作成に使用されます。
配列内の最初のプロファイルと最後のプロファイルは、デバイス プロファイルである必要があります。 その他のプロファイルには、色空間または抽象プロファイルを指定できます。
各プロファイルの出力色空間は、次のプロファイルの入力色空間である必要があります。
呼び出し元のアプリケーションは、この関数によって割り当てられ、 pProfileData パラメーターによって指されるバッファーを解放する必要があります。 バッファーを解放するには、 GlobalFree 関数を使用する必要があります。
要件
| サポートされている最小のクライアント | Windows 2000 Professional [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows 2000 Server [デスクトップ アプリのみ] |
| Header | icm.h |
| Library | Mscms.lib |
| [DLL] | Mscms.dll |