次の方法で共有


GetICMProfileW 関数 (wingdi.h)

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

構文

BOOL GetICMProfileW(
  HDC     hdc,
  LPDWORD pBufSize,
  LPWSTR  pszFilename
);

パラメーター

hdc

カラー プロファイルの取得元となるデバイス コンテキストを指定します。

pBufSize

lpszFilenameによって指されるバッファーのサイズを含む DWORD ポインター。 この関数の ANSI バージョンの場合、サイズはバイト単位です。 Unicode バージョンの場合、サイズは WCHAR 単位です。 この関数が成功した場合、このパラメーターには実際に使用されるバッファーのサイズが格納されます。 ただし、バッファーが十分な大きさでない場合、この関数は FALSE返します。 この場合、GetLastError() 関数はERROR_INSUFFICIENT_BUFFERを返し、このパラメーターで指 DWORD には、lpszFilename バッファーに必要なサイズが含まれています。

pszFilename

プロファイルのパス名を受け取るバッファーを指します。

戻り値

この関数が成功した場合、戻り値は 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 Systemsの Unicode 用 Microsoft Layer で説明されているように、特定のファイルをアプリケーションに追加する必要があります。

手記

wingdi.h ヘッダーは、Unicode プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして GetICMProfile を定義します。 エンコードに依存しないエイリアスをエンコードに依存しないコードと組み合わせて使用すると、コンパイルエラーやランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「関数プロトタイプの 規則」を参照してください。

必要条件

要件 価値
サポートされる最小クライアント Windows 2000 Professional [デスクトップ アプリのみ]
サポートされる最小サーバー Windows 2000 Server [デスクトップ アプリのみ]
ターゲット プラットフォーム の ウィンドウズ
ヘッダー wingdi.h
ライブラリ Gdi32.lib
DLL Gdi32.dll

関連項目