共用方式為


WcsGetDefaultColorProfileSize 函式 (icm.h)

傳回裝置的預設色彩配置檔名稱大小,以位元組為單位, (包括 NULL 終止符) 。

注意

此 API 不支援 HDR 監視器的「進階色彩」配置檔。 使用 ColorProfileGetDisplayDefault 來管理進階色彩配置檔。

語法

BOOL WcsGetDefaultColorProfileSize(
  WCS_PROFILE_MANAGEMENT_SCOPE scope,
  PCWSTR                       pDeviceName,
  COLORPROFILETYPE             cptColorProfileType,
  COLORPROFILESUBTYPE          cpstColorProfileSubType,
  DWORD                        dwProfileID,
  PDWORD                       pcbProfileName
);

參數

scope

指定此設定檔管理作業範圍的 WCS_PROFILE_MANAGEMENT_SCOPE 值。

pDeviceName

要取得預設色彩配置檔之裝置名稱的指標。 如果 為 NULL,則會使用與裝置無關的預設配置檔。

cptColorProfileType

指定色彩配置檔類型的 COLORPROFILETYPE 值。

cpstColorProfileSubType

指定色彩配置文件子類型的 COLORPROFILESUBTYPE 值。

dwProfileID

色彩配置檔所代表之色彩空間的標識碼。

pcbProfileName

接收預設色彩配置檔路徑名稱之位元組大小的位置指標,包括 NULL 終止符。

傳回值

如果此函式成功,則傳回值為 TRUE

如果此函式失敗,則傳回值為 FALSE。 如需擴充的錯誤資訊,請呼叫 GetLastError

備註

使用此函式可傳回 WcsGetDefaultColorProfile 函式中 pProfileName 參數所指向之緩衝區的必要大小。

此函式可在 Least-Privileged 用戶帳戶 (LUA) 內容中執行。

規格需求

需求
最低支援的用戶端 Windows 2000 Professional [僅限傳統型應用程式]
最低支援的伺服器 Windows 2000 Server [僅限桌面應用程式]
標頭 icm.h
程式庫 Mscms.lib
Dll Mscms.dll

另請參閱