次の方法で共有

WcsSetDefaultColorProfile 関数 (icm.h)

  • [アーティクル]

指定したプロファイル管理スコープ内の指定したプロファイルの種類の既定のカラー プロファイル名を設定します。

注意

この API では、HDR モニターの "高度な色" プロファイルはサポートされていません。 ColorProfileSetDisplayDefaultAssociation を使用して、高度なカラー プロファイルを管理します。

構文

BOOL WcsSetDefaultColorProfile(
  WCS_PROFILE_MANAGEMENT_SCOPE scope,
  PCWSTR                       pDeviceName,
  COLORPROFILETYPE             cptColorProfileType,
  COLORPROFILESUBTYPE          cpstColorProfileSubType,
  DWORD                        dwProfileID,
  LPCWSTR                      pProfileName
);

パラメーター

scope

このプロファイル管理操作のスコープを指定する WCS_PROFILE_MANAGEMENT_SCOPE 値。

pDeviceName

既定のカラー プロファイルを設定するデバイスの名前へのポインター。 NULL の場合、デバイスに依存しない既定のプロファイルが使用されます。

cptColorProfileType

カラー プロファイルの種類を指定する COLORPROFILETYPE 値。

cpstColorProfileSubType

カラー プロファイルサブタイプを指定する COLORPROFILESUBTYPE 値。

dwProfileID

カラー プロファイルが表す色空間の ID。 これは、アプリケーション内の色空間プロファイルを一意に識別するために使用されるカスタム ID 値です。

pProfileName

カラー プロファイルの名前を保持するバッファーへのポインター。 「解説」を参照してください。

戻り値

この関数が成功した場合、戻り値は TRUE になります。

この関数が失敗した場合、戻り値は FALSE になります。 拡張エラー情報については、 GetLastError を呼び出します。

解説

pProfileName パラメーターが NULL で、profileManagementScope パラメーターがWCS_PROFILE_MANAGEMENT_SCOPE_CURRENT_USERされている場合、後続の WcsSetDefaultColorProfile の呼び出しはシステム全体の既定のプロファイルを返します。

profileManagementScope がWCS_PROFILE_MANAGEMENT_SCOPE_CURRENT_USER場合、この関数はユーザー アカウント (LUA) コンテキスト Least-Privileged 実行可能です。 それ以外の場合は、管理特権が必要です。 指定したプロファイルは既にインストールされている必要がありますが、指定されたプロファイル管理スコープ内の指定されたデバイスにまだ関連付けられていない可能性があります。

profileManagementScope がWCS_PROFILE_MANAGEMENT_SCOPE_CURRENT_USERされている場合、システム コンテキストから起動された場合、この関数は正しく機能せず、ユーザー アカウントからは機能しません。

デバイス モデル プロファイル DMP を RGB またはカスタム作業空間の既定のプロファイルとして設定するために WcsSetDefaultColorProfile が呼び出されると、RGBVirtualDevice、LCD、または CRT の種類の DMP プロファイルのみが有効です。それ以外はすべて無効です。

WCsSetDefaultColorProfile を呼び出して、国際色コンソーシアム (ICC) プロファイルを RGB またはカスタム作業空間の既定のプロファイルとして設定する場合、クラス "spac" または "disp"、および "RGB" 色空間を持つ ICC プロファイルのみが有効です。それ以外はすべて無効です。

有効なプロファイルの種類とサブタイプの組み合わせに関する注意事項を参照してください。

要件

   
サポートされている最小のクライアント Windows 2000 Professional [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows 2000 Server [デスクトップ アプリのみ]
Header icm.h
Library Mscms.lib
[DLL] Mscms.dll

関連項目