IWICBitmapEncoder::CreateNewFrame 메서드(wincodec.h)

새 IWICBitmapFrameEncode instance 만듭니다.

구문

HRESULT CreateNewFrame(
  [out]     IWICBitmapFrameEncode **ppIFrameEncode,
  [in, out] IPropertyBag2         **ppIEncoderOptions
);

매개 변수

[out] ppIFrameEncode

형식: IWICBitmapFrameEncode**

IWICBitmapFrameEncode의 새 instance 대한 포인터를 수신하는 포인터입니다.

[in, out] ppIEncoderOptions

형식: IPropertyBag2**

선택 사항입니다. 후속 프레임 초기화에 사용할 명명된 속성을 받습니다. 설명 부분을 참조하세요.

반환 값

형식: HRESULT

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

설명

매개 변수 ppIEncoderOptions 를 사용하여 IPropertyBag2 를 수신한 다음 인코더 옵션을 지정하는 데 사용할 수 있습니다. 이 작업은 ppIEncoderOptions의 NULL IPropertyBag2 포인터에 포인터를 전달하여 수행됩니다. 반환된 IPropertyBag2는 지정된 형식에 사용할 수 있는 모든 인코더 옵션을 기본값으로 사용하여 초기화됩니다. 기본이 아닌 인코딩 동작을 지정하려면 IPropertyBag2에서 필요한 인코더 옵션을 설정하고 IWICBitmapFrameEncode::Initialize에 전달합니다.

참고 초기화된 IPropertyBag2에 대한 포인터를 전달하지 마세요. 포인터를 덮어쓰고 원래 IPropertyBag2가 해제되지 않습니다.

 

그렇지 않으면 인코더 옵션을 지정하지 않으려는 경우 ppIEncoderOptions에서 NULL을 전달할 수 있습니다.

인코더 옵션을 설정하는 방법에 대한 예제는 인코딩 개요를 참조하세요.

여러 프레임(예: TIFF, JPEG-XR) 인코딩을 지원하는 형식의 경우 한 번에 하나의 프레임에서만 작업할 수 있습니다. 즉, CreateNewFrame을 다시 호출하기 전에 IWICBitmapFrameEncode::Commit을 호출해야 합니다.

요구 사항

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

추가 정보

인코딩 개요

IPropertyBag2

IWICBitmapEncoder