Image::GetEncoderParameterList-Methode (gdiplusheaders.h)

Die Image::GetEncoderParameterList-Methode ruft eine Liste der Parameter ab, die von einem angegebenen Bildencoder unterstützt werden.

Syntax

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

Parameter

[in] clsidEncoder

Typ: const CLSID*

Zeiger auf eine CLSID , die den Encoder angibt.

[in] size

Typ: UINT

Ganzzahl, die die Größe des Pufferarrays in Bytes angibt. Rufen Sie die Image::GetEncoderParameterListSize-Methode auf, um die erforderliche Größe abzurufen.

[out] buffer

Typ: EncoderParameters*

Zeiger auf ein EncoderParameters-Objekt , das die Liste der unterstützten Parameter empfängt.

Rückgabewert

Typ: Status

Wenn die Methode erfolgreich ist, gibt sie OK zurück, ein Element der Status-Enumeration .

Wenn die Methode fehlschlägt, gibt sie eines der anderen Elemente der Status-Enumeration zurück.

Hinweise

Die Image::GetEncoderParameterList-Methode gibt ein Array von EncoderParameter-Objekten zurück. Bevor Sie Image::GetEncoderParameterList aufrufen, müssen Sie einen Puffer zuordnen, der groß genug ist, um dieses Array zu empfangen, das Teil eines EncoderParameters-Objekts ist. Sie können die Image::GetEncoderParameterListSize-Methode aufrufen, um die Größe des erforderlichen EncoderParameters-Objekts in Bytes abzurufen.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP, Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	gdiplusheaders.h (include Gdiplus.h)
Bibliothek	Gdiplus.lib
DLL	Gdiplus.dll

Weitere Informationen

GetImageEncoder

GetImageEncodersSize

Image

Image::GetEncoderParameterListSize

Verwenden von Bildencodern und -decodern