GetStandardColorSpaceProfileA 関数 (icm.h)
指定した標準色空間に登録されているカラー プロファイルを取得 します。
構文
BOOL GetStandardColorSpaceProfileA(
PCSTR pMachineName,
DWORD dwSCS,
PSTR pBuffer,
PDWORD pcbSize
);
パラメーター
pMachineName
予約済み。 NULL にする必要があります。 このパラメーターは、標準の色空間プロファイルを取得するコンピューターの名前を指すことを目的としています。 NULL ポインターは、ローカル コンピューターを示します。
dwSCS
プロファイルを取得する標準色空間の ID 値を指定します。 このパラメーターの有効な値は、LCS_sRGBとLCS_WINDOWS_COLOR_SPACEのみです。
pBuffer
プロファイルの名前が配置されるバッファーへのポインター。 NULL の場合、呼び出しは TRUE を返し、バッファーの必要なサイズは pdwSize に配置されます。
pcbSize
pProfileName が指すバッファーのサイズ (バイト単位) を含む変数へのポインター。 戻り値の場合、変数には実際に使用または必要なバッファーのサイズが含まれます。
戻り値
この関数が成功した場合、戻り値は TRUE になります。
この関数が失敗した場合、戻り値は FALSE になります。 拡張エラー情報については、 GetLastError を呼び出します。
解説
pProfileName によって指されるバッファーがアプリケーションによって動的に割り当てられる場合、アプリケーションは GetStandardColorSpaceProfile 関数を呼び出して、バッファーに必要なサイズを取得できます。 pProfileName を NULL に設定して GetStandardColorSpaceProfile を呼び出すと、FALSE が返され、pdwSize が指す DWORD には pProfileName が指すバッファーに必要なバイト数が含まれます。 その後、アプリケーションはバッファーを割り当てて、pProfileName をバッファーのアドレスに設定して GetStandardColorSpaceProfile を再度呼び出すことができます。
この関数は、International Color Consortium (ICC) プロファイルに加えて、Windows Color System (WCS) デバイス モデル プロファイル (DMP) をサポートします。 WCS CAMP または GMMP プロファイルはサポートされておらず、そのようなプロファイルが使用されている場合はエラーが返されます。
Windows Vista 固有の機能の概要
これにより、ICC プロファイルに加えて WCS DMP がサポートされます。 WCS CAMP または GMMP プロファイルはサポートされず、このようなプロファイルがこの API で使用されている場合はエラーが返されます。
ユーザーごと/LUA のサポート
これにより、現在のユーザーの指定された標準色空間に登録されているカラー プロファイルが取得されます。 現在のユーザーにこのような設定がない場合は、システム全体の設定を取得します。
これにより、 WCS_PROFILE_MANAGEMENT_SCOPE_CURRENT_USERで WcsGetDefaultColorProfile が使用されます。
これは LUA コンテキストで実行可能です。
要件
| サポートされている最小のクライアント | Windows 2000 Professional [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows 2000 Server [デスクトップ アプリのみ] |
| Header | icm.h |
| Library | Mscms.lib |
| [DLL] | Mscms.dll |