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

備註

呼叫此方法之後，就無法再存取 Just-committed 畫面上的資料。 相反地，新的空白框架會附加至影像，而 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()