IWICBitmapCodecInfo::GetPixelFormats-Methode (wincodec.h)

Artikel
03/06/2024

Ruft die vom Codec unterstützten Pixelformate ab.

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 beim ersten Aufruf, um die erforderliche Arraygröße zu bestimmen.

[in, out] pguidPixelFormats

Typ: GUID*

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

[out] pcActual

Typ: UINT*

Die Arraygröße, die zum Abrufen aller unterstützten Pixelformate erforderlich ist.

Rückgabewert

Typ: HRESULT

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

Hinweise

Das Verwendungsmuster für diese Methode ist ein Zwei-Aufrufprozess. Der erste Aufruf ruft die Arraygröße ab, die zum Abrufen aller unterstützten Pixelformate erforderlich ist, indem sie aufgerufen wird, wobei cFormats auf 0 und pguidPixelFormats auf NULLfestgelegt ist. Dieser Aufruf legt pcActual auf die erforderliche Arraygröße fest. Sobald die erforderliche Arraygröße ermittelt wurde, ruft ein zweiter GetPixelFormats-Aufruf , bei dem pguidPixelFormats auf ein Array der entsprechenden Größe festgelegt ist, die Pixelformate ab.

Anforderungen

Anforderung	Wert
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

Freigeben über