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>>

指定したエンコード オプション。 1 つ以上のコーデック固有のエンコード オプションと必要な値を含むキーと値のペアのコレクション。

戻り値

IAsyncAction

現在のフレーム データをコミットし、編集する新しい空のフレームを追加する非同期操作を管理する オブジェクト。

属性

OverloadAttribute RemoteAsyncAttribute

注釈

新しい BitmapPropertySet を作成することで、encodingOptions パラメーターに渡すことができるキーと値のペアのコレクションを取得できます。

エンコード オプションの使用の詳細については、「 CreateAsync(Guid, IRandomAccessStream, IIterable(IKeyValuePair))」 を参照してください。

こちらもご覧ください

• BitmapPropertySet
• GoToNextFrameAsync()