PCMSCALLBACKW

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

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

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

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

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

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

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

コールバック関数は完全に省略可能です。指定しない場合、Color Management ダイアログ ボックスに Apply ボタンは表示されません。Microsoft は、アプリケーションでコールバック関数を提供することを強く推奨しています。