IWICBitmapFrameEncode::SetColorContexts 메서드(wincodec.h)

지정된 수 의 IWICColorContext 프로필을 프레임으로 설정합니다.

구문

HRESULT SetColorContexts(
  [in] UINT             cCount,
  [in] IWICColorContext **ppIColorContext
);

매개 변수

[in] cCount

형식: UINT

설정할 IWICColorContext 프로필의 수입니다.

[in] ppIColorContext

형식: IWICColorContext**

프레임으로 설정할 색 컨텍스트 프로필을 포함하는 IWICColorContext 포인터에 대한 포인터입니다.

반환 값

형식: HRESULT

메서드가 성공하면 S_OK를 반환하고, 그러지 않으면 HRESULT 오류 코드를 반환합니다.

설명

• Bmp색 컨텍스트 설정은 지원되지 않습니다. 이 함수는 WINCODEC_ERR_UNSUPPORTEDOPERATION 반환합니다.
• Png최대 하나의 색 컨텍스트 설정이 지원되며 추가 색 컨텍스트는 무시됩니다. 이 컨텍스트는 WICColorContextProfile이어야 하며 PNG 파일에서 iCCP, gAMA 및 cHRM 청크를 인코딩하는 데 사용됩니다.
• JPEG, TIFF, JPEG-XRWICColorContextProfile 1개와 WICColorContextExifColorSpace 1개까지 설정이 지원됩니다. 각 형식의 마지막 컨텍스트를 제외한 모든 색 컨텍스트는 무시되므로 사용자는 각 색 컨텍스트 유형 중 하나 이상을 제공하지 않아야 합니다. JPEG에서 WICColorContextProfile 은 JPEG APP2 ICC 메타데이터 블록으로 인코딩됩니다.

  TIFF 및 JPEG-XR에서 WICColorContextProfile 은 IFD ICC 프로필 메타데이터 블록(IFD 태그 0x8773)으로 인코딩됩니다. 세 가지 형식 모두 WICColorContextExifColorSpace 는 EXIF 색 영역 메타데이터 블록(EXIF 태그 0xA001)으로 인코딩됩니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	WINDOWS XP SP2, Windows Vista [데스크톱 앱 | UWP 앱]
지원되는 최소 서버	Windows Server 2008 [데스크톱 앱 | UWP 앱]
대상 플랫폼	Windows
헤더	wincodec.h
라이브러리	Windowscodecs.lib