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에 전달합니다.
인코더 옵션을 설정하는 방법에 대한 예제는 인코딩 개요를 참조하세요.
여러 프레임(예: TIFF, JPEG-XR) 인코딩을 지원하는 형식의 경우 한 번에 하나의 프레임에서만 작업할 수 있습니다. 즉, CreateNewFrame을 다시 호출하기 전에 IWICBitmapFrameEncode::Commit을 호출해야 합니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | WINDOWS XP SP2, Windows Vista [데스크톱 앱 | UWP 앱] |
| 지원되는 최소 서버 | Windows Server 2008 [데스크톱 앱 | UWP 앱] |
| 대상 플랫폼 | Windows |
| 헤더 | wincodec.h |
| 라이브러리 | Windowscodecs.lib |
| DLL | Windowscodecs.dll |