Compartilhar via


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

O método Image::GetEncoderParameterList obtém uma lista dos parâmetros compatíveis com um codificador de imagem especificado.

Sintaxe

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

Parâmetros

[in] clsidEncoder

Tipo: const CLSID*

Ponteiro para um CLSID que especifica o codificador.

[in] size

Tipo: UINT

Inteiro que especifica o tamanho, em bytes, da matriz de buffers . Chame o método Image::GetEncoderParameterListSize para obter o tamanho necessário.

[out] buffer

Tipo: EncoderParameters*

Ponteiro para um objeto EncoderParameters que recebe a lista de parâmetros com suporte.

Retornar valor

Tipo: Status

Se o método for bem-sucedido, ele retornará Ok, que é um elemento da enumeração Status .

Se o método falhar, ele retornará um dos outros elementos da enumeração Status .

Comentários

O método Image::GetEncoderParameterList retorna uma matriz de objetos EncoderParameter . Antes de chamar Image::GetEncoderParameterList, você deve alocar um buffer grande o suficiente para receber essa matriz, que faz parte de um objeto EncoderParameters . Você pode chamar o método Image::GetEncoderParameterListSize para obter o tamanho, em bytes, do objeto EncoderParameters necessário.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows XP, Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho gdiplusheaders.h (inclua Gdiplus.h)
Biblioteca Gdiplus.lib
DLL Gdiplus.dll

Confira também

Getimageencoders

GetImageEncodersSize

Imagem

Image::GetEncoderParameterListSize

Usando codificadores de imagem e decodificadores