GetImageEncoders-Funktion (gdiplusimagecodec.h)

Artikel
02/26/2024

Die GetImageEncoders-Funktion ruft ein Array von ImageCodecInfo-Objekten ab, die Informationen zu den verfügbaren Bildencodern enthalten.

Syntax

Status GetImageEncoders(
  [in]  UINT           numEncoders,
  [in]  UINT           size,
  [out] ImageCodecInfo *encoders
);

Parameter

[in] numEncoders

Typ: UINT

Ganzzahl, die die Anzahl der verfügbaren Bildencoder angibt. Rufen Sie GetImageEncodersSize auf, um diese Nummer zu ermitteln.

[in] size

Typ: UINT

Ganzzahl, die die Größe des Arrays von ImageCodecInfo-Objekten in Bytes angibt. Rufen Sie GetImageEncodersSize auf, um diese Nummer zu ermitteln.

[out] encoders

Typ: ImageCodecInfo*

Zeiger auf einen Puffer, der das Array der ImageCodecInfo-Objekte empfängt. Sie müssen Arbeitsspeicher für diesen Puffer zuweisen. Rufen Sie GetImageEncodersSize auf, um die Größe des erforderlichen Puffers zu bestimmen.

Rückgabewert

Typ: Status

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

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

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	gdiplusimagecodec.h (include Gdiplus.h)
Bibliothek	Gdiplus.lib