IWICBitmapEncoder::Commit-Methode (wincodec.h)

  • Artikel

Committ alle Änderungen für das Image und schließt den Stream.

Syntax

HRESULT Commit();

Rückgabewert

Typ: HRESULT

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

Hinweise

Um ein Bild abzuschließen, muss sowohl der Framecommit als auch der Encodercommit aufgerufen werden. Rufen Sie die Commit-Methode des Encoders jedoch erst auf, nachdem alle Frames committet wurden.

Nachdem der Encoder committet wurde, kann er nicht erneut initialisiert oder mit einem anderen Stream wiederverwendet werden. Eine neue Encoderschnittstelle muss beispielsweise mit IWICImagingFactory::CreateEncoder erstellt werden.

Damit der Encodercommitten erfolgreich ist, müssen Sie mindestens IWICBitmapEncoder::Initialize und entweder IWICBitmapFrameEncode::WriteSource oder IWICBitmapFrameEncode::WritePixels aufrufen.

IWICBitmapFrameEncode::WriteSource gibt alle Parameter an, die zum Codieren der Bilddaten erforderlich sind. IWICBitmapFrameEncode::WritePixels erfordert, dass Sie auch IWICBitmapFrameEncode::SetSize, IWICBitmapFrameEncode::SetPixelFormat und IWICBitmapFrameEncode::SetPalette aufrufen (wenn das Pixelformat indiziert ist).

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

Commit

IWICBitmapEncoder