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