PCMSCALLBACKA

*PCMSCALLBACKA*（または ApplyCallbackFunction）は、SetupColorMatchingW 関数が表示するダイアログ ボックスの実行中に WCS 構成データを更新する、あなたが実装するコールバック関数です。 名前 ApplyCallbackFunction はプレースホルダーです。このコールバック関数の実際の名前は、ICM を使用するアプリケーションが指定します。

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

この関数が失敗した場合、戻り値は FALSE です。コールバック関数は、SetLastError を呼び出して拡張エラー情報を設定できます。

ApplyCallbackFunction 関数は、色の管理（Color Management）ダイアログ ボックスの表示中に、デバイスの WCS 構成を変更するために使用します。色の管理ダイアログ ボックスは、SetupColorMatchingW 関数によって表示されます。

コールバック関数を指定した場合、ダイアログ ボックスの右下に 適用（Apply）ボタンが表示されます。適用 ボタンを選択すると、コールバック関数は直ちに、設定対象のデバイスの構成を更新します。色の管理ダイアログ ボックスは画面に表示されたままです。

アプリケーションは、SetupColorMatchingW 関数に渡す COLORMATCHSETUPW 構造体にコールバック関数のアドレスを格納することで、WCS にコールバック関数を指定します。アドレスは、COLORMATCHSETUP 構造体の lPfnApplyCallback メンバーに格納します。dwFlags メンバーには CMS_USEAPPLYCALLBACK を設定する必要があります。設定しない場合、コールバック関数は無視されます。

アプリケーションが指定した値を、コールバック関数に渡すことができます。SetupColorMatchingW 関数を呼び出す前に、アプリケーションは COLORMATCHSETUPW 構造体の lParamApplyCallback メンバーに値を格納できます。コールバック関数が呼び出されるとき、lParamApplyCallback 構造体メンバーの値が、その lParam パラメーターでコールバック関数に渡されます。

コールバック関数は完全に任意です。指定しない場合、色の管理ダイアログ ボックスに 適用 ボタンは表示されません。アプリケーションでコールバック関数を指定することを、Microsoft は強く推奨します。