BitmapEncoder.GoToNextFrameAsync 方法

定义

命名空间:

Windows.Graphics.Imaging

重载

GoToNextFrameAsync()	异步提交当前帧数据，并追加要编辑的新空帧。
GoToNextFrameAsync(IIterable<KeyValuePair<String,BitmapTypedValue>>)	异步提交当前帧数据，并使用指定的编码选项追加要编辑的新空帧。

GoToNextFrameAsync()

异步提交当前帧数据，并追加要编辑的新空帧。

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

返回

IAsyncAction

一个 对象，用于管理提交当前帧数据和追加要编辑的新空帧的异步操作。

属性

OverloadAttribute RemoteAsyncAttribute

注解

调用此方法后，不再可访问刚提交的帧上的数据。 相反，会将新的空框架追加到图像中，并且 BitmapEncoder 上的后续读取和写入操作将访问此帧。 无法“倒退”到以前提交的帧。

如果当前帧是图像中的最后一帧，请不要调用此方法，因为这样会导致图像末尾出现多余的空帧。 请改为调用 FlushAsync ，这将提交帧并关闭整个 BitmapEncoder。 例如，在大多数情况下，应用程序只需保存单帧图像。 在这些情况下，永远不应调用 GoToNextFrameAsync。

首次调用此方法时，将提交所有容器级数据以及第一个帧数据。 之后，任何访问容器级数据的尝试都将失败。

另请参阅

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

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

异步提交当前帧数据，并使用指定的编码选项追加要编辑的新空帧。

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

参数

encodingOptions

IIterable<IKeyValuePair<String,BitmapTypedValue>>

IEnumerable<KeyValuePair<String,BitmapTypedValue>>

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

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

指定的编码选项。 键值对的集合，其中包含一个或多个特定于编解码器的编码选项和所需值。

返回

IAsyncAction

一个 对象，用于管理提交当前帧数据和追加要编辑的新空帧的异步操作。

属性

OverloadAttribute RemoteAsyncAttribute

注解

可以通过创建新的 BitmapPropertySet 来获取键值对的集合，这些键值对可以传递给 encodingOptions 参数。

有关使用编码选项的详细信息 ，请参阅 CreateAsync (Guid、IRandomAccessStream、IIterable (IKeyValuePair) ) 。

另请参阅

• BitmapPropertySet
• GoToNextFrameAsync()