다음을 통해 공유


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

인코더가 지정된 픽셀 형식을 사용하도록 요청합니다.

구문

HRESULT SetPixelFormat(
  [in, out] WICPixelFormatGUID *pPixelFormat
);

매개 변수

[in, out] pPixelFormat

형식: WICPixelFormatGUID*

입력에서 요청된 픽셀 형식 GUID입니다. 출력에서 인코더에서 지원하는 가장 가까운 픽셀 형식 GUID입니다. 요청된 형식과 다를 수 있습니다. 픽셀 형식 GUID 목록은 네이티브 픽셀 형식을 참조하세요.

반환 값

형식: HRESULT

가능한 반환 값은 다음과 같습니다.

반환 코드 Description
S_OK
성공.
WINCODEC_ERR_WRONGSTATE
IWICBitmapFrameEncode::Initialize 메서드가 호출되지 않았습니다.

설명

인코더는 요청된 픽셀 형식을 지원하지 않을 수 있습니다. 그렇지 않은 경우 SetPixelFormatpPixelFormat 이 가리키는 메모리 블록에서 가장 가까운 일치 항목을 반환합니다. 반환된 픽셀 형식이 요청된 형식과 일치하지 않는 경우 IWICFormatConverter 개체를 사용하여 픽셀 데이터를 변환해야 합니다.

요구 사항

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

추가 정보

IWICBitmapFrameEncode

네이티브 픽셀 형식