다음을 통해 공유

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 메서드가 호출되지 않았습니다.

설명

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

요구 사항

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

추가 정보

IWICBitmapFrameEncode

네이티브 픽셀 형식