Método Image::GetEncoderParameterList (gdiplusheaders.h)

El método Image::GetEncoderParameterList obtiene una lista de los parámetros admitidos por un codificador de imagen especificado.

Sintaxis

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

Parámetros

[in] clsidEncoder

Tipo: const CLSID*

Puntero a un CLSID que especifica el codificador.

[in] size

Tipo: UINT

Entero que especifica el tamaño, en bytes, de la matriz de búfer . Llame al método Image::GetEncoderParameterListSize para obtener el tamaño necesario.

[out] buffer

Tipo: EncoderParameters*

Puntero a un objeto EncoderParameters que recibe la lista de parámetros admitidos.

Valor devuelto

Tipo: Estado

Si el método se ejecuta correctamente, devuelve Ok, que es un elemento de la enumeración Status .

Si se produce un error en el método, devuelve uno de los otros elementos de la enumeración Status .

Comentarios

El método Image::GetEncoderParameterList devuelve una matriz de objetos EncoderParameter . Antes de llamar a Image::GetEncoderParameterList, debe asignar un búfer lo suficientemente grande como para recibir esa matriz, que forma parte de un objeto EncoderParameters . Puede llamar al método Image::GetEncoderParameterListSize para obtener el tamaño, en bytes, del objeto EncoderParameters necesario.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows XP, Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	gdiplusheaders.h (include Gdiplus.h)
Library	Gdiplus.lib
Archivo DLL	Gdiplus.dll

Consulte también

GetImageEncoders

GetImageEncodersSize

Imagen

Image::GetEncoderParameterListSize

Uso de codificadores y descodificadores de imágenes