Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Schreibt Zeilen von den Quellebenen in das codierte Format.
Syntax
HRESULT WritePixels(
UINT lineCount,
[in] WICBitmapPlane *pPlanes,
UINT cPlanes
);
Parameter
lineCount
Typ: UINT
Die Anzahl der zu codierenden Zeilen. Im Abschnitt Hinweise finden Sie informationen zu einschränkungen der WIC Jpeg-spezifischen Zeilenanzahl.
[in] pPlanes
Typ: WICBitmapPlane*
Gibt die Quellpuffer für jede codierte Komponentenebene an.
cPlanes
Typ: UINT
Die Anzahl der vom pPlanes-Parameter angegebenen Komponentenebenen .
Rückgabewert
Typ: HRESULT
Wenn die Ebenen und das Quellrechteck die Anforderungen nicht erfüllen, schlägt diese Methode mit WINCODEC_ERR_IMAGESIZEOUTOFRANGE fehl.
Wenn das IWICBitmapSource-Format die Encoderanforderungen nicht erfüllt, schlägt diese Methode mit WINCODEC_ERR_UNSUPPORTEDPIXELFORMAT fehl.
Hinweise
Es wird davon ausgegangen, dass aufeinanderfolgende WritePixels-Aufrufe dem Ausgabebild sequenziell Scanlines hinzugefügt werden. IWICBitmapFrameEncode::Initialize, IWICBitmapFrameEncode::SetSize und IWICBitmapFrameEncode::SetPixelFormat müssen aufgerufen werden, bevor diese Methode fehlschlägt.
Das über IWICBitmapFrameEncode::SetPixelFormat festgelegte verschachtelte Pixelformat und die codecspezifischen Codierungsparameter bestimmen die unterstützten planaren Formate.
WIC JPEG Encoder: QueryInterface kann verwendet werden, um diese Schnittstelle aus der WIC JPEG IWICBitmapFrameEncode-Implementierung abzurufen. Wenn Sie diese Methode verwenden, um Y'CbCr-Daten mit dem WIC JPEG-Encoder zu codieren, kann die Chroma-Subsampling während der Frameerstellung mit Encoderoptionen konfiguriert werden. Weitere Informationen finden Sie unter Codierungsübersicht und IWICBitmapEncoder::CreateNewFrame .
Abhängig von der konfigurierten Chroma-Subsampling hat der lineCount-Parameter die folgenden Einschränkungen:
| Chroma-Subsampling | Einschränkung der Zeilenanzahl | Breite der Chromaebene | Höhe der Chromaebene |
|---|---|---|---|
| 4:2:0 | Vielfaches von 2, es sei denn, der Anruf deckt die letzte Scanlinie des Bilds ab. | lumaWidth / 2 Auf die nächste ganze Zahl aufgerundet. | lumaHeight / 2 auf die nächste ganze Zahl aufgerundet. |
| 4:2:2 | Any | lumaWidth / 2 Auf die nächste ganze Zahl aufgerundet. | Any |
| 4:4:4 | Any | Any | Any |
| 4:4:0 | Vielfaches von 2, es sei denn, der Anruf deckt die letzte Scanlinie des Bilds ab. | Any | llumaHeight / 2 aufgerundet auf die nächste ganze Zahl. |
Die vollständige Scanlinienbreite muss codiert sein, und die Breite der Bitmapquellen muss mit ihrer planaren Konfiguration übereinstimmen.
Wenn ein Pixelformat über IWICBitmapFrameEncode::SetPixelFormat festgelegt wird, muss es GUID_WICPixelFormat24bppBGR werden.
Die unterstützten Pixelformate der An diese Methode übergebenen Bitmapquellen sind wie folgt:
| Ebenenanzahl | Ebene 1 | Ebene 2 | Ebene 3 |
|---|---|---|---|
| 3 | GUID_WICPixelFormat8bppY | GUID_WICPixelFormat8bppCb | GUID_WICPixelFormat8bppCr |
| 2 | GUID_WICPixelFormat8bppY | GUID_WICPixelFormat16bppCbCr | – |
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 8.1 [Desktop-Apps | UWP-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2012 R2 [Desktop-Apps | UWP-Apps] |
| Zielplattform | Windows |
| Kopfzeile | wincodec.h |
| Bibliothek | Windowscodecs.lib |
| DLL | Windowscodecs.dll |