WcsSetDefaultColorProfile 함수(icm.h)
지정된 프로필 관리 scope 지정된 프로필 형식의 기본 색 프로필 이름을 설정합니다.
참고
이 API는 HDR 모니터에 대한 "고급 색" 프로필을 지원하지 않습니다. 고급 색 프로필을 관리하기 위해 ColorProfileSetDisplayDefaultAssociation 을 사용합니다.
구문
BOOL WcsSetDefaultColorProfile(
WCS_PROFILE_MANAGEMENT_SCOPE scope,
PCWSTR pDeviceName,
COLORPROFILETYPE cptColorProfileType,
COLORPROFILESUBTYPE cpstColorProfileSubType,
DWORD dwProfileID,
LPCWSTR pProfileName
);
매개 변수
scope
이 프로필 관리 작업의 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 경우 이 함수는 Least-Privileged LUA(사용자 계정) 컨텍스트에서 실행 가능합니다. 그렇지 않으면 관리 권한이 필요합니다. 지정된 프로필은 이미 설치되어 있어야 하지만 지정된 프로필 관리 scope 지정된 디바이스와 아직 연결되지 않은 것일 수 있습니다.
profileManagementScope가 WCS_PROFILE_MANAGEMENT_SCOPE_CURRENT_USER 경우 사용자 계정이 아닌 시스템 컨텍스트에서 시작된 경우 이 함수가 제대로 작동하지 않습니다.
디바이스 모델 프로필 DMP를 RGB 또는 사용자 지정 작업 공간의 기본 프로필로 설정하기 위해 WcsSetDefaultColorProfile이 호출되면 RGBVirtualDevice, LCD 또는 CRT 형식의 DMP 프로필만 유효합니다. 다른 모든 항목이 잘못되었습니다.
WcsSetDefaultColorProfile을 호출하여 ICC(International Color Consortium) 프로필을 RGB 또는 사용자 지정 작업 공간의 기본 프로필로 설정하는 경우 클래스 "spac" 또는 "disp"가 있는 ICC 프로필만 있고 "RGB" 색 공간은 유효합니다. 다른 모든 항목이 잘못되었습니다.
유효한 프로필 유형/하위 형식 조합에 대한 참고 사항을 참조하세요.
요구 사항
| 지원되는 최소 클라이언트 | Windows 2000 Professional[데스크톱 앱만] |
| 지원되는 최소 서버 | Windows 2000 Server[데스크톱 앱만] |
| 머리글 | icm.h |
| 라이브러리 | Mscms.lib |
| DLL | Mscms.dll |