IWICBitmapFrameEncode::SetPixelFormat-Methode (wincodec.h)

Fordert an, dass der Encoder das angegebene Pixelformat verwendet.

Syntax

HRESULT SetPixelFormat(
  [in, out] WICPixelFormatGUID *pPixelFormat
);

Parameter

[in, out] pPixelFormat

Typ: WICPixelFormatGUID*

Bei der Eingabe die angeforderte Pixelformat-GUID. Bei der Ausgabe die nächstgelegene Pixelformat-GUID, die vom Encoder unterstützt wird; Dies kann sich vom angeforderten Format unterscheiden. Eine Liste der PIXELformat-GUIDs finden Sie unter Native Pixelformate.

Rückgabewert

Typ: HRESULT

Folgende Rückgabewerte sind möglich.

Rückgabecode BESCHREIBUNG
S_OK
Erfolg.
WINCODEC_ERR_WRONGSTATE
Die IWICBitmapFrameEncode::Initialize-Methode wurde nicht aufgerufen.

Hinweise

Möglicherweise unterstützt der Encoder das angeforderte Pixelformat nicht. Andernfalls gibt SetPixelFormat die nächste Übereinstimmung im Speicherblock zurück, auf den pPixelFormat verweist. Wenn das zurückgegebene Pixelformat nicht mit dem angeforderten Format übereinstimmt, müssen Sie zum Konvertieren der Pixeldaten ein IWICFormatConverter-Objekt verwenden.

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

Weitere Informationen

IWICBitmapFrameEncode

Native Pixelformate