IWICBitmapEncoder::CreateNewFrame-Methode (wincodec.h)
Erstellt eine neue IWICBitmapFrameEncode-instance.
Syntax
HRESULT CreateNewFrame(
[out] IWICBitmapFrameEncode **ppIFrameEncode,
[in, out] IPropertyBag2 **ppIEncoderOptions
);
Parameter
[out] ppIFrameEncode
Typ: IWICBitmapFrameEncode**
Ein Zeiger, der einen Zeiger auf die neue instance eines IWICBitmapFrameEncode empfängt.
[in, out] ppIEncoderOptions
Typ: IPropertyBag2**
Optional. Empfängt die benannten Eigenschaften, die für die nachfolgende Frameinitialisierung verwendet werden sollen. Siehe Hinweise.
Rückgabewert
Typ: HRESULT
Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.
Hinweise
Der Parameter ppIEncoderOptions kann verwendet werden, um eine IPropertyBag2-Instanz zu empfangen, die dann zum Angeben von Encoderoptionen verwendet werden kann. Hierzu wird ein Zeiger auf einen NULL-IPropertyBag2-Zeiger in ppIEncoderOptions übergeben. Der zurückgegebene IPropertyBag2 wird mit allen Encoderoptionen initialisiert, die für das angegebene Format mit ihren Standardwerten verfügbar sind. Um ein nicht standardmäßiges Codierungsverhalten anzugeben, legen Sie die erforderlichen Encoderoptionen für IPropertyBag2 fest, und übergeben Sie sie an IWICBitmapFrameEncode::Initialize.
Ein Beispiel zum Festlegen von Encoderoptionen finden Sie unter Übersicht über die Codierung.
Für Formate, die die Codierung mehrerer Frames unterstützen (z. B. TIFF, JPEG-XR), können Sie jeweils nur an einem Frame arbeiten. Dies bedeutet, dass Sie IWICBitmapFrameEncode::Commit aufrufen müssen, bevor Sie CreateNewFrame erneut aufrufen.
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 |