Image::GetEncoderParameterList method

The Image::GetEncoderParameterList method gets a list of the parameters supported by a specified image encoder.

Syntax

Status GetEncoderParameterList(
  IN const CLSID        *clsidEncoder,
  IN UINT               size,
  OUT EncoderParameters *buffer
);

Parameters

clsidEncoder

Type: const CLSID*

Pointer to a CLSID that specifies the encoder.

size

Type: UINT

Integer that specifies the size, in bytes, of the buffer array. Call the Image::GetEncoderParameterListSize method to obtain the required size.

buffer

Type: EncoderParameters*

Pointer to an EncoderParameters object that receives the list of supported parameters.

Return Value

Type: Type: Status

If the method succeeds, it returns Ok, which is an element of the Status enumeration.

If the method fails, it returns one of the other elements of the Status enumeration.

Remarks

The Image::GetEncoderParameterList method returns an array of EncoderParameter objects. Before you call Image::GetEncoderParameterList, you must allocate a buffer large enough to receive that array, which is part of an EncoderParameters object. You can call the Image::GetEncoderParameterListSize method to get the size, in bytes, of the required EncoderParameters object.

Requirements

   
Minimum supported client Windows XP, Windows 2000 Professional [desktop apps only]
Minimum supported server Windows 2000 Server [desktop apps only]
Target Platform Windows
Header gdiplusheaders.h (include Gdiplus.h)
Library Gdiplus.lib
DLL Gdiplus.dll

See Also

GetImageEncoders

GetImageEncodersSize

Image

Image::GetEncoderParameterListSize

Using Image Encoders and Decoders