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.

Hinweis Übergeben Sie keinen Zeiger auf einen initialisierten IPropertyBag2. Der Zeiger wird überschrieben, und der ursprüngliche IPropertyBag2 wird nicht freigegeben.

 

Andernfalls können Sie NULL in ppIEncoderOptions übergeben, wenn Sie keine Encoderoptionen angeben möchten.

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

Weitere Informationen

Übersicht über die Codierung

IPropertyBag2

IWICBitmapEncoder