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