IWICBitmapCodecInfo::GetPixelFormats-Methode (wincodec.h)

Ruft die Pixelformate ab, die der Codec unterstützt.

Syntax

HRESULT GetPixelFormats(
  [in]      UINT cFormats,
  [in, out] GUID *pguidPixelFormats,
  [out]     UINT *pcActual
);

Parameter

[in] cFormats

Typ: UINT

Die Größe des PguidPixelFormats-Arrays . Verwenden Sie 0 den ersten Aufruf, um die erforderliche Arraygröße zu ermitteln.

[in, out] pguidPixelFormats

Typ: GUID*

Empfängt die unterstützten Pixelformate. Verwenden Sie NULL den ersten Aufruf, um die erforderliche Arraygröße zu bestimmen.

[out] pcActual

Typ: UINT*

Die Arraygröße, die benötigt wird, um alle unterstützten Pixelformate abzurufen.

Rückgabewert

Typ: HRESULT

Wenn diese Methode erfolgreich ist, gibt sie S_OK zurück. Andernfalls wird ein HRESULT-Fehlercode zurückgegeben.

Bemerkungen

Das Verwendungsmuster für diese Methode ist ein zwei Aufrufprozess. Der erste Aufruf ruft die Arraygröße ab, die benötigt wird, um alle unterstützten Pixelformate abzurufen, indem er mit cFormats auf 0 und pguidPixelFormats festgelegt NULList. Dieser Aufruf legt pcActual auf die erforderliche Arraygröße fest. Nachdem die erforderliche Arraygröße bestimmt wurde, ruft ein zweiter GetPixelFormats-Aufruf mit pguidPixelFormats auf ein Array der entsprechenden Größe zurück.

Anforderungen

   
Unterstützte Mindestversion (Client) Windows XP mit SP2, Windows Vista [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 [Desktop-Apps | UWP-Apps]
Zielplattform Windows
Kopfzeile wincodec.h
Bibliothek Windowscodecs.lib
DLL Windowscodecs.dll