다음을 통해 공유

CMCheckColorsInGamut 함수(icm.h)

  • 아티클

[CMCheckColorsInGamut 은 Windows Vista에서 더 이상 사용할 수 없습니다.]

지정된 RGB 삼중이 지정된 변환의 출력 영역 안에 있는지 여부를 결정합니다.

구문

BOOL CMCheckColorsInGamut(
  HCMTRANSFORM hcmTransform,
  RGBTRIPLE    *lpaRGBTriple,
  LPBYTE       lpaResult,
  UINT         nCount
);

매개 변수

hcmTransform

사용할 변환을 지정합니다.

lpaRGBTriple

검사 RGB 삼중 배열을 가리킵니다.

lpaResult

결과를 넣을 버퍼를 가리킵니다.

결과는 바이트 배열로 표시됩니다. 배열의 각 바이트는 RGB 트리플에 해당하며 부호 없는 값은 0에서 255 사이입니다. 값 0은 색이 영역 안에 있음을 나타내는 반면, 0이 아닌 값은 색이 영역 외부임을 나타냅니다. 0 <n< 255 범위의 정수 n의 경우 n + 1의 결과 값은 n의 결과 값으로 표시되는 것과 같이 해당 색이 적어도 범위에서 멀리 떨어져 있음을 나타냅니다.

nCount

배열에 있는 요소의 수를 지정합니다.

반환 값

Windows Vista부터 기본 CMM(Icm32.dll)은 FALSE 를 반환하고 GetLastError 는 ERROR_NOT_SUPPORTED 보고합니다.

Windows Server 2003, Windows XP 및 Windows 2000:

이 함수가 성공하면 반환 값은 TRUE입니다.

이 함수가 실패하면 반환 값은 FALSE입니다. GetLastError를 호출하여 오류를 검색합니다.

설명

Windows Vista부터 이 메서드를 구현하기 위해 CMM 구현자가 더 이상 필요하지 않습니다.

Windows Server 2003, Windows XP 및 Windows 2000:

이 메서드를 구현하려면 CMM 구현자가 필요합니다.

이 함수를 내보내려면 모든 CMM이 필요합니다.

함수가 성공하지 못하면 사용자 지정 CMM은 SetLastError 를 호출하여 마지막 오류를 Winerror.h에 정의된 유효한 오류 값으로 설정해야 합니다.

요구 사항

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

추가 정보