Metodo Image::GetEncoderParameterList (gdiplusheaders.h)

Articolo
02/27/2024

Il metodo Image::GetEncoderParameterList ottiene un elenco dei parametri supportati da un codificatore di immagini specificato.

Sintassi

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

Parametri

[in] clsidEncoder

Tipo: const CLSID*

Puntatore a un CLSID che specifica il codificatore.

[in] size

Tipo: UINT

Intero che specifica le dimensioni, in byte, della matrice di buffer . Chiamare il metodo Image::GetEncoderParameterListSize per ottenere le dimensioni necessarie.

[out] buffer

Tipo: EncoderParameters*

Puntatore a un oggetto EncoderParameters che riceve l'elenco dei parametri supportati.

Valore restituito

Tipo: Stato

Se il metodo ha esito positivo, restituisce Ok, ovvero un elemento dell'enumerazione Status .

Se il metodo ha esito negativo, restituisce uno degli altri elementi dell'enumerazione Status .

Commenti

Il metodo Image::GetEncoderParameterList restituisce una matrice di oggetti EncoderParameter . Prima di chiamare Image::GetEncoderParameterList, è necessario allocare un buffer abbastanza grande per ricevere tale matrice, che fa parte di un oggetto EncoderParameters . È possibile chiamare il metodo Image::GetEncoderParameterListSize per ottenere le dimensioni, in byte, dell'oggetto EncoderParameters richiesto.

Requisiti

Requisito	Valore
Client minimo supportato	Windows XP, Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	gdiplusheaders.h (include Gdiplus.h)
Libreria	Gdiplus.lib
DLL	Gdiplus.dll