BitmapEncoder.GoToNextFrameAsync Methode

Definition

Namespace:

Windows.Graphics.Imaging

Überlädt

GoToNextFrameAsync()	Committ die aktuellen Framedaten asynchron und fügt einen neuen leeren Frame an, der bearbeitet werden soll.
GoToNextFrameAsync(IIterable<KeyValuePair<String,BitmapTypedValue>>)	Committ die aktuellen Framedaten asynchron und fügt einen neuen leeren Frame mit den angegebenen Codierungsoptionen an, die bearbeitet werden sollen.

GoToNextFrameAsync()

Committ die aktuellen Framedaten asynchron und fügt einen neuen leeren Frame an, der bearbeitet werden soll.

public:
 virtual IAsyncAction ^ GoToNextFrameAsync() = GoToNextFrameAsync;

/// [Windows.Foundation.Metadata.Overload("GoToNextFrameAsync")]
/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncAction GoToNextFrameAsync();

[Windows.Foundation.Metadata.Overload("GoToNextFrameAsync")]
[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncAction GoToNextFrameAsync();

function goToNextFrameAsync()

Public Function GoToNextFrameAsync () As IAsyncAction

Gibt zurück

IAsyncAction

Ein -Objekt, das den asynchronen Vorgang des Commits der aktuellen Framedaten und das Anfügen eines neuen leeren Frames verwaltet, der bearbeitet werden soll.

Attribute

OverloadAttribute RemoteAsyncAttribute

Hinweise

Nachdem diese Methode aufgerufen wurde, kann nicht mehr auf Daten im Frame mit just-committet werden. Stattdessen wird ein neuer, leerer Frame an das Bild angefügt, und nachfolgende Lese- und Schreibvorgänge auf dem BitmapEncoder greifen auf diesen Frame zu. Sie können nicht zu einem zuvor committeten Frame "zurückspulen".

Rufen Sie diese Methode nicht auf, wenn der aktuelle Frame der letzte Frame im Bild sein soll, da dies zu einem überflüssigen, leeren Frame am Ende des Bilds führt. Rufen Sie stattdessen FlushAsync auf, das den Frame committet und den gesamten BitmapEncoder schließt. In den meisten Szenarien muss die Anwendung beispielsweise nur ein Einzelbild speichern. In diesen Fällen sollte GoToNextFrameAsync nie aufgerufen werden.

Wenn diese Methode zum ersten Mal aufgerufen wird, werden alle Daten auf Containerebene sowie die ersten Framedaten committet. Danach schlagen alle Versuche, auf Daten auf Containerebene zuzugreifen, fehl.

Weitere Informationen

• GoToNextFrameAsync(IIterable<KeyValuePair<String,BitmapTypedValue>>)

GoToNextFrameAsync(IIterable<KeyValuePair<String,BitmapTypedValue>>)

Committ die aktuellen Framedaten asynchron und fügt einen neuen leeren Frame mit den angegebenen Codierungsoptionen an, die bearbeitet werden sollen.

public:
 virtual IAsyncAction ^ GoToNextFrameAsync(IIterable<IKeyValuePair<Platform::String ^, BitmapTypedValue ^> ^> ^ encodingOptions) = GoToNextFrameAsync;

/// [Windows.Foundation.Metadata.Overload("GoToNextFrameWithEncodingOptionsAsync")]
/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncAction GoToNextFrameAsync(IIterable<IKeyValuePair<winrt::hstring, BitmapTypedValue const&>> const& encodingOptions);

[Windows.Foundation.Metadata.Overload("GoToNextFrameWithEncodingOptionsAsync")]
[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncAction GoToNextFrameAsync(IEnumerable<KeyValuePair<string,BitmapTypedValue>> encodingOptions);

function goToNextFrameAsync(encodingOptions)

Public Function GoToNextFrameAsync (encodingOptions As IEnumerable(Of KeyValuePair(Of String, BitmapTypedValue))) As IAsyncAction

Parameter

encodingOptions

IIterable<IKeyValuePair<String,BitmapTypedValue>>

IEnumerable<KeyValuePair<String,BitmapTypedValue>>

IIterable<IKeyValuePair<Platform::String,BitmapTypedValue>>

IIterable<IKeyValuePair<winrt::hstring,BitmapTypedValue>>

Die angegebenen Codierungsoptionen. Eine Sammlung von Schlüssel-Wert-Paaren, die eine oder mehrere codecspezifische Codierungsoptionen und die gewünschten Werte enthalten.

Gibt zurück

IAsyncAction

Ein -Objekt, das den asynchronen Vorgang des Commits der aktuellen Framedaten und das Anfügen eines neuen leeren Frames verwaltet, der bearbeitet werden soll.

Attribute

OverloadAttribute RemoteAsyncAttribute

Hinweise

Sie können eine Auflistung von Schlüssel-Wert-Paaren abrufen, die Sie an den encodingOptions-Parameter übergeben können, indem Sie ein neues BitmapPropertySet erstellen.

Weitere Informationen zur Verwendung von Codierungsoptionen finden Sie unter CreateAsync(Guid, IRandomAccessStream, IIterable(IKeyValuePair) ).

Weitere Informationen

• BitmapPropertySet
• GoToNextFrameAsync()