Image::GetEncoderParameterList 메서드(gdiplusheaders.h)

아티클
02/26/2024

Image::GetEncoderParameterList 메서드는 지정된 이미지 인코더에서 지원하는 매개 변수 목록을 가져옵니다.

구문

Status GetEncoderParameterList(
  [in]  const CLSID       *clsidEncoder,
  [in]  UINT              size,
  [out] EncoderParameters *buffer
);

매개 변수

[in] clsidEncoder

형식: const CLSID*

인코더를 지정하는 CLSID 에 대한 포인터입니다.

[in] size

형식: UINT

버퍼 배열의 크기(바이트)를 지정하는 정수입니다. 필요한 크기를 얻으려면 Image::GetEncoderParameterListSize 메서드를 호출합니다.

[out] buffer

형식: EncoderParameters*

지원되는 매개 변수 목록을 수신하는 EncoderParameters 개체에 대한 포인터입니다.

반환 값

형식: 상태

메서드가 성공하면 Status 열거형의 요소인 확인을 반환합니다.

메서드가 실패하면 Status 열거형의 다른 요소 중 하나를 반환합니다.

설명

Image::GetEncoderParameterList 메서드는 EncoderParameter 개체의 배열을 반환합니다. Image::GetEncoderParameterList를 호출하기 전에 EncoderParameters 개체의 일부인 해당 배열을 받을 수 있을 만큼 큰 버퍼를 할당해야 합니다. Image::GetEncoderParameterListSize 메서드를 호출하여 필요한 EncoderParameters 개체의 크기를 바이트 단위로 가져올 수 있습니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows XP, Windows 2000 Professional [데스크톱 앱만 해당]
지원되는 최소 서버	Windows 2000 Server[데스크톱 앱만]
대상 플랫폼	Windows
헤더	gdiplusheaders.h(Gdiplus.h 포함)
라이브러리	Gdiplus.lib
DLL	Gdiplus.dll