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 |