IWICFormatConverterInfo::GetPixelFormats-Methode (wincodec.h)

Artikel
03/03/2024

Ruft eine Liste von GUIDs ab, die angibt, welche Pixelformate der Konverter unterstützt.

Syntax

HRESULT GetPixelFormats(
  [in]      UINT               cFormats,
  [in, out] WICPixelFormatGUID *pPixelFormatGUIDs,
  [out]     UINT               *pcActual
);

Parameter

[in] cFormats

Typ: UINT

Die Größe des pPixelFormatGUIDs-Arrays .

[in, out] pPixelFormatGUIDs

Typ: WICPixelFormatGUID*

Zeiger auf ein GUID-Array, das die vom Konverter unterstützten Pixelformate empfängt.

[out] pcActual

Typ: UINT*

Die tatsächliche Arraygröße, die zum Abrufen aller vom Konverter 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

Der Formatkonverter garantiert nicht unbedingt symmetrisch in Bezug auf die Konvertierung; Das heißt, ein Konverter kann FROM in ein bestimmtes Format konvertieren, ohne tatsächlich in ein bestimmtes Format konvertieren zu können. Verwenden Sie CanConvert, um die Symmetrie zu testen.

Um die Anzahl der Pixelformate zu bestimmen, die ein Konverter verarbeiten kann, legen Sie cFormats auf 0 und pPixelFormatGUIDs auf NULLfest. Der Konverter füllt pcActual mit der Anzahl der von diesem Konverter unterstützten Formate aus.

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