GetICMProfileW

GetICMProfile 関数は、指定したデバイスコンテキストの現在の出力カラープロファイルのファイル名を取得する。(Unicode)

GetICMProfileW hdc, pBufSize, pszFilename

hdc : [intptr] カラープロファイルを取得する対象のデバイスコンテキストを指定する。
pBufSize : [var] lpszFilename が指すバッファのサイズを含む DWORD へのポインタ。この関数の ANSI 版ではサイズはバイト単位、Unicode 版では WCHAR 単位である。関数が成功すると、戻り時にこのパラメータは実際に使用されたバッファサイズを含む。ただしバッファが十分でない場合、この関数は FALSE を返す。この場合 GetLastError() は ERROR_INSUFFICIENT_BUFFER を返し、このパラメータが指す DWORD には lpszFilename バッファに必要なサイズが格納される。
pszFilename : [wstr] プロファイルのパス名を受け取るバッファを指す。

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

解説

GetICMProfile 関数は、指定したデバイスコンテキストの現在の出力カラープロファイルのファイル名を取得する。(Unicode)

[戻り値]
関数が成功した場合、戻り値は TRUE である。lpszFilename が NULL で、必要なバッファサイズが lpcbName
にコピーされた場合も TRUE を返す。関数が失敗した場合は FALSE を返す。

[備考]
GetICMProfile
は、デバイスコンテキストのカラーマネジメントが有効かどうかに関わらず、現在の出力プロファイルのファイル名を取得する。デバイスコンテキストを与えると、GetICMProfile
は lpszFilename
パラメータを通じて、現在デバイスコンテキストで使用されているカラープロファイルを含むファイルのパス名を出力する。また lpcbName
パラメータを通じてパス名を含む文字列の長さを出力する。GetICMProfile が返すプロファイル名は EnumICMProfiles
が返すプロファイル一覧に含まれない可能性がある。EnumICMProfiles 関数は、デバイスコンテキスト (DC)
に関連付けられ、かつ DC の設定に一致するすべてのカラースペースプロファイルを返す。SetICMProfile
関数で現在のプロファイルを設定した場合、DC 設定に一致しないプロファイルが関連付けられることがある。例えば、SetICMProfile
関数でデバイス非依存の sRGB プロファイルを DC に関連付けることができる。このプロファイルはその DC の現在の WCS
プロファイルとして使用され、GetICMProfile 呼び出しではそのファイル名が返される。ただし、EnumICMProfiles
が返すプロファイル一覧には現れない。SetICMProfile
の呼び出し前にこの関数を呼び出すと、デバイスコンテキストのデフォルトプロファイルを取得するために使用できる。Windows
95/98/Me: GetICMProfileW は Microsoft Layer for Unicode
でサポートされる。使用するには、Windows 95/98/Me 向け Microsoft Layer for Unicode
の説明に従って、特定のファイルをアプリケーションに追加する必要がある。
> [!NOTE] > wingdi.h ヘッダは GetICMProfile をエイリアスとして定義しており、UNICODE
プリプロセッサ定数の有無に応じてこの関数の ANSI 版または Unicode
版が自動的に選択される。エンコーディング中立なエイリアスと非中立コードを混在させると、コンパイルまたは実行時エラーの原因となる不整合を引き起こすことがある。詳細は
[関数プロトタイプの規則](/windows/win32/intl/conventions-for-function-prototypes)
を参照。

情報