EnumICMProfilesW

EnumICMProfiles 関数は、指定したデバイスコンテキストに対してシステムがサポートする各種出力カラープロファイルを列挙する。(Unicode)

EnumICMProfilesW hdc, proc, param2

hdc : [intptr] デバイスコンテキストを指定する。
proc : [int] アプリケーションが定義したコールバック関数のプロシージャインスタンスアドレスを指定する(EnumICMProfilesProcCallback を参照)。
param2 : [intptr] 

(プラグイン / モジュール : gdi32.dll)

解説

EnumICMProfiles
関数は、指定したデバイスコンテキストに対してシステムがサポートする各種出力カラープロファイルを列挙する。(Unicode)

[戻り値]
アプリケーションが列挙を中断した場合、この関数は 0 を返す。列挙すべきカラープロファイルが存在しない場合、戻り値は -1
である。それ以外の場合、戻り値はコールバック関数が最後に返した値である。

[備考]
EnumICMProfiles 関数は、デバイスコンテキスト (DC) に関連付けられ、かつその DC
の設定に一致するプロファイルの一覧を返す。デバイスコンテキストには、特定のハードウェアデバイスに関連付けられていないデバイスプロファイルや、DC
の設定に一致しないデバイスプロファイルが含まれる場合がある。sRGB プロファイルはその例である。SetICMProfile
関数はこの種のプロファイルを DC に関連付けるために使用される。GetICMProfile 関数を使えば、EnumICMProfiles
関数では列挙されないプロファイルを取得できる。Windows 95/98/Me: EnumICMProfilesW は Microsoft
Layer for Unicode でサポートされる。使用するには、Windows 95/98/Me 向け Microsoft Layer
for Unicode の説明に従って、特定のファイルをアプリケーションに追加する必要がある。
> [!NOTE] > wingdi.h ヘッダは EnumICMProfiles をエイリアスとして定義しており、UNICODE
プリプロセッサ定数の有無に応じてこの関数の ANSI 版または Unicode
版が自動的に選択される。エンコーディング中立なエイリアスと非中立コードを混在させると、コンパイルまたは実行時エラーの原因となる不整合を引き起こすことがある。詳細は
[関数プロトタイプの規則](/windows/win32/intl/conventions-for-function-prototypes)
を参照。

情報