IWICBitmapFrameEncode::WriteSource-Methode (wincodec.h)

Codiert eine Bitmapquelle.

Syntax

HRESULT WriteSource(
  [in] IWICBitmapSource *pIBitmapSource,
  [in] WICRect          *prc
);

Parameter

[in] pIBitmapSource

Typ: IWICBitmapSource*

Die zu codierende Bitmapquelle.

[in] prc

Typ: WICRect*

Das Größenrechteck der Bitmapquelle.

Rückgabewert

Typ: HRESULT

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

Hinweise

Wenn SetSize vor dem Aufrufen von WriteSource nicht aufgerufen wird, wird die in prc angegebene Größe verwendet, wenn nicht NULL. Andernfalls wird die in pIBitmapSource angegebene Größe der IWICBitmapSource verwendet.

Wenn SetPixelFormat vor dem Aufrufen von WriteSource nicht aufgerufen wird, wird das Pixelformat der in pIBitmapSource angegebenen IWICBitmapSource verwendet.

Wenn SetResolution vor dem Aufrufen von WriteSource nicht aufgerufen wird, wird das Pixelformat von pIBitmapSource verwendet.

Wenn SetPalette vor dem Aufrufen von WriteSource nicht aufgerufen wird, wird das Zielpixelformat indiziert und das Pixelformat von pIBitmapSource dem Pixelformat des Encoderframes entspricht, wird das Pixelformat pIBitmapSource verwendet.

Wenn beim Codieren eines GIF-Bilds die globale Palette festgelegt ist und die Bildebenenpalette nicht direkt vom Benutzer oder von einem benutzerdefinierten GIF-Codec des unabhängigen Softwareanbieters (ISV) festgelegt wird, verwendet WriteSource die globale Palette, um den Frame zu codieren, selbst wenn pIBitmapSource über eine Palette auf Frameebene verfügt.

Ab Windows Vista können wiederholte WriteSource-Aufrufe ausgeführt werden, solange die gesamt akkumulierte Quellrekthöhe mit der über SetSize festgelegten Höhe identisch ist.

Ab Windows 8.1 muss das Quellrekt mindestens die dimensionen sein, die über SetSize festgelegt sind. Wenn die Breite des Quellrekts die SetSize-Breite überschreitet, werden zusätzliche Pixel auf der rechten Seite ignoriert. Wenn die Quellrekthöhe die verbleibende nicht ausgefüllte Höhe überschreitet, werden zusätzliche Scanzeilen am unteren Rand ignoriert.

Anforderungen

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

Siehe auch

Konzept

Schreiben eines WIC-Enabled CODEC

IWICBitmapFrameEncode

Übersicht über die Windows-Bildverarbeitungskomponente