GetICMProfileA 関数 (wingdi.h)
GetICMProfile 関数は、指定されたデバイス コンテキストの現在の出力カラー プロファイルのファイル名を取得します。
構文
BOOL GetICMProfileA(
HDC hdc,
LPDWORD pBufSize,
LPSTR 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 の Microsoft Layer for Unicode」で説明されているように、特定のファイルをアプリケーションに追加する必要があります。
注意
wingdi.h ヘッダーは、GetICMProfile をエイリアスとして定義します。このエイリアスは、UNICODE プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択します。 encoding-neutral エイリアスの使用を encoding-neutral ではないコードと混在すると、コンパイル エラーまたはランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「 関数プロトタイプの規則」を参照してください。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows 2000 Professional [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows 2000 Server [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | wingdi.h |
| Library | Gdi32.lib |
| [DLL] | Gdi32.dll |