Share via


IImageEncoder::GetEncoderParameterList

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

This method retrieves a list of all parameters supported by the image encoder.

Syntax

HRESULT GetEncoderParameterList(
  UINT                size,
  EncoderParameters* Params
);

Parameters

  • Params
    [out] A pointer to an array of EncoderParameters objects that the method populates with data for the individual parameters.

Return Value

If successful, this method returns S_OK.

This method may return E_NOTIMPL if it fails.

Remarks

The following code shows a parameter list returned by IImageEncoder::GetEncoderParameterList.

Count = 2
Params[0] = {
  ENCODER_COMPRESSION, 
  3, 
  EncoderParameterValueTypeLong, 
  { // Value
    EncoderValueCompressionLZW,
    EncoderValueCompressionRle,
    EncoderValueCompressionNone
  }
}
Params[1] = {
  ENCODER_SAVE_FLAG,
  1,
  EncoderParameterValueTypeLong,
  { // Value
    EncoderValueMultiFrame
  }
}

Requirements

Header imaging.h
Library Imaging.lib
Windows Embedded CE Windows CE 5.0 and later
Windows Mobile Windows Mobile Version 5.0 and later

See Also

Reference

IImageEncoder
IImageEncoder::GetEncoderParameterListSize
EncoderParameters