次の方法で共有


BitmapEncoder.GoToNextFrameAsync メソッド

定義

オーバーロード

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

戻り値

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

属性

注釈

このメソッドが呼び出されると、just-committed フレーム上のデータにアクセスできなくなります。 代わりに、新しい空のフレームがイメージに追加され、 BitmapEncoder の後続の読み取りと書き込みによってこのフレームにアクセスします。 以前にコミットされたフレームに "巻き戻し" することはできません。

現在のフレームがイメージの最後のフレームであることを意図している場合は、このメソッドを呼び出さないでください。これにより、イメージの末尾に余分な空のフレームが発生するためです。 代わりに、 FlushAsync を呼び出してフレームをコミットし、 BitmapEncoder 全体を閉じます。 たとえば、ほとんどのシナリオでは、アプリケーションは単一フレームイメージのみを保存する必要があります。 このような場合、GoToNextFrameAsync を呼び出さないでください。

このメソッドが初めて呼び出されると、すべてのコンテナー レベル のデータと最初のフレーム データがコミットされます。 その後、コンテナー レベルのデータにアクセスしようとすると失敗します。

こちらもご覧ください

適用対象

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 つ以上のコーデック固有のエンコード オプションと必要な値を含むキーと値のペアのコレクション。

戻り値

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

属性

注釈

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

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

こちらもご覧ください

適用対象