IWICBitmapCodecInfo::GetPixelFormats-Methode (wincodec.h)

  • Artikel

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