다음을 통해 공유

WcsOpenColorProfileW 함수(icm.h)

  • 아티클

지정된 색 프로필에 대한 핸들을 만듭니다.

구문

HPROFILE WcsOpenColorProfileW(
  PPROFILE pCDMPProfile,
  PPROFILE pCAMPProfile,
  PPROFILE pGMMPProfile,
  DWORD    dwDesireAccess,
  DWORD    dwShareMode,
  DWORD    dwCreationMode,
  DWORD    dwFlags
);

매개 변수

pCDMPProfile

프로필을 지정하는 WCS DMP 또는 ICC 색 프로필 구조에 대한 포인터입니다. 핸들을 만든 후 pCDMPProfile 포인터를 해제할 수 있습니다. 프로필이 ICC이고 해당 dwType 멤버가 DONT_USE_EMBEDDED_WCS_PROFILES 설정된 경우 WcsOpenColorProfile 은 ICC 프로필 내에 포함된 WCS 프로필을 무시합니다.

pCAMPProfile

WCS CAMP(색 모양 모델 프로필)를 지정하는 프로필 구조에 대한 포인터입니다. 핸들을 만든 후 pCAMPProfile 포인터를 해제할 수 있습니다. NULL이면 기본 CAMP가 사용되고 현재 사용자 설정인 WCS_PROFILE_MANAGEMENT_SCOPE_CURRENT_USER 기본 CAMP를 쿼리하는 동안 사용됩니다.

pGMMPProfile

WCS GMMP(영역 맵 모델 프로필)를 지정하는 프로필 구조에 대한 포인터입니다. 핸들을 만든 후 pGMMPProfile 포인터를 해제할 수 있습니다. NULL이면 기본 렌더링 의도에 대한 기본 GMMP가 사용되고 기본 GMMP를 쿼리하는 동안 현재 사용자 설정인 WCS_PROFILE_MANAGEMENT_SCOPE_CURRENT_USER 사용됩니다. 렌더링 의도에 대한 설명은 렌더링 의도를 참조하세요.

dwDesireAccess

지정된 색 프로필에 액세스하는 방법을 지정하는 플래그 값입니다. 이 매개 변수는 다음 값 중 하나를 사용해야 합니다.

값 Description
PROFILE_READ 읽기 전용 액세스를 위해 색 프로필이 열리게 지정합니다.
PROFILE_READWRITE 읽기 및 쓰기 액세스 모두에 대해 색 프로필이 열리게 지정합니다. 프로필이 WCS 프로필인 경우 이 플래그의 값은 무시됩니다.

dwShareMode

파일에 포함된 색 프로필을 여는 동안 수행할 작업을 지정하는 플래그 값입니다. 이 매개 변수는 winnt.h에 정의된 다음 값 중 하나를 사용해야 합니다.

값 Description
FILE_SHARE_READ 프로필에서 다른 열린(읽기 액세스용) 작업을 수행할 수 있도록 지정합니다.
FILE_SHARE_WRITE 프로필에서 다른 열린(쓰기 액세스용) 작업을 수행할 수 있도록 지정합니다. 이 플래그 값은 WCS 프로필을 열 때 무시됩니다.

dwCreationMode

파일에 포함된 경우 색 프로필을 여는 동안 수행할 작업을 지정하는 플래그 값입니다. 이 매개 변수는 winbase.h에 정의된 다음 값 중 하나를 사용해야 합니다.

값 Description
CREATE_NEW 새 프로필이 만들어지게 지정합니다. 프로필이 이미 있는 경우 이 함수가 실패합니다.
CREATE_ALWAYS 새 프로필이 만들어지게 지정합니다. 프로필이 이미 있는 경우 덮어씁니다.
OPEN_EXISTING 프로필을 열게 지정합니다. 프로필이 없으면 이 함수가 실패합니다.
OPEN_ALWAYS ICC(International Color Consortium) 파일이 있는 경우 프로필을 열도록 지정합니다. ICC 프로필이 없는 경우 WCS는 새 ICC 프로필을 만듭니다. 이 플래그가 설정되고 WCS 프로필이 없는 경우 함수는 WCS 프로필에 대해 실패합니다.
TRUNCATE_EXISTING 프로필을 열고 0바이트로 자르도록 지정합니다. 프로필이 없으면 함수가 실패합니다.

dwFlags

포함된 WCS 프로필을 사용할지 여부를 지정하는 플래그 값입니다. pCDMProfile이 포함된 WCS 프로필을 포함하는 ICC 프로필을 지정하지 않는 한 이 매개 변수는 효과가 없습니다.

이 매개 변수는 다음 값 중 하나를 사용합니다.

값 Description
0 포함된 WCS 프로필이 사용되고 pCDMPProfile에서 지정한 ICC 프로필이 무시되도록 지정합니다.
DONT_USE_EMBEDDED_WCS_PROFILES pCDMPProfile에서 지정한 ICC 프로필이 사용되고 포함된 WCS 프로필이 무시되도록 지정합니다.

반환 값

이 함수가 성공하면 반환 값은 열려 있는 색 프로필의 핸들입니다.

이 함수가 실패하면 반환 값은 NULL입니다.

설명

이 API는 DMP, CAMP 및 GMMP 집합을 가져와서 WCS 프로필 핸들을 반환합니다. GMMP에 대한 NULL 값은 유효합니다. CAMP의 NULL 값은 기본 CAMP 값으로 바뀝니다.

이 API는 ICC 프로필도 수락합니다. ICC 프로필을 사용하면 WCS CITE 엔진의 처리가 보장되지 않습니다. WCS 엔진은 하나 이상의 WCS 프로필을 전달하는 경우에만 사용됩니다. 순수 ICC 워크플로는 레거시 동작과 일치합니다.

이 함수가 다른 색 프로필 관리 함수에서 반환하는 핸들을 사용할 수 있습니다.

dwCreationMode 플래그는 CREATE_NEW, CREATE_ALWAYS 및 TRUNCATE_EXISTING 항상 빈 ICC HPROFILE을 반환합니다. 다른 dwCreationMode 플래그가 있는 경우 함수는 프로필이 ICC 또는 WCS XML인지 여부를 결정합니다.

ICC 코드 경로 내에서 ICC HPROFILE은 위의 표에 지정된 대로 요청된 공유, 액세스 및 생성 플래그를 사용하여 반환됩니다.

WCS 아키텍처 내에서 WCS 프로필을 만들거나 편집할 수 없으므로 프로필이 없으면 dwCreationMode 플래그 OPEN_ALWAYS 실패합니다(MSXML6을 사용하여 외부에서 편집해야 함). 같은 이유로 dwShareMode 플래그는 FILE_SHARE_WRITE dwDesiredAccess 플래그 PROFILE_READWRITE WCS 경로 내에서 무시됩니다.

색 프로필에 대한 핸들이 만들어지면 해당 핸들을 만드는 데 사용되는 모든 정보를 삭제할 수 있습니다.

CloseColorProfile 함수를 사용하여 WcsOpenColorProfile에서 반환되는 개체 핸들을 닫습니다.

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows 2000 Professional[데스크톱 앱만]
지원되는 최소 서버 Windows 2000 Server[데스크톱 앱만]
머리글 icm.h
라이브러리 Mscms.lib
DLL Mscms.dll

추가 정보