BitmapEncoder.GoToNextFrameAsync Método

Definición

Espacio de nombres:

Windows.Graphics.Imaging

Sobrecargas

GoToNextFrameAsync()	Confirma de forma asincrónica los datos de fotogramas actuales y anexa un nuevo marco vacío que se va a editar.
GoToNextFrameAsync(IIterable<KeyValuePair<String,BitmapTypedValue>>)	Confirma de forma asincrónica los datos de fotogramas actuales y anexa un nuevo marco vacío, con las opciones de codificación especificadas, que se van a editar.

GoToNextFrameAsync()

Confirma de forma asincrónica los datos de fotogramas actuales y anexa un nuevo marco vacío que se va a editar.

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

Devoluciones

IAsyncAction

Objeto que administra la operación asincrónica de confirmar los datos de fotogramas actuales y anexar un nuevo marco vacío que se va a editar.

Atributos

OverloadAttribute RemoteAsyncAttribute

Comentarios

Después de llamar a este método, los datos del marco just-committed ya no son accesibles. En su lugar, se anexa un marco vacío nuevo a la imagen y las lecturas y escrituras posteriores en bitmapEncoder accederán a este fotograma. No se puede "rebobinar" en un fotograma confirmado previamente.

No llames a este método si el marco actual está pensado para ser el último fotograma de la imagen, ya que esto dará como resultado un marco superfluo y vacío al final de la imagen. En su lugar, llame a FlushAsync , que confirmará el fotograma y cerrará todo el bitmapEncoder. Por ejemplo, en la mayoría de los escenarios, la aplicación solo necesita guardar una imagen de fotograma único. En estos casos, nunca se debe llamar a GoToNextFrameAsync.

La primera vez que se llama a este método, se confirman todos los datos de nivel de contenedor, así como los primeros datos de fotogramas. Después, se producirá un error en los intentos de acceder a los datos de nivel de contenedor.

Consulte también

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

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

Confirma de forma asincrónica los datos de fotogramas actuales y anexa un nuevo marco vacío, con las opciones de codificación especificadas, que se van a editar.

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

Parámetros

encodingOptions

IIterable<IKeyValuePair<String,BitmapTypedValue>>

IEnumerable<KeyValuePair<String,BitmapTypedValue>>

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

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

Opciones de codificación especificadas. Colección de pares clave-valor que contienen una o varias opciones de codificación específicas del códec y los valores deseados.

Devoluciones

IAsyncAction

Objeto que administra la operación asincrónica de confirmar los datos de fotogramas actuales y anexar un nuevo marco vacío que se va a editar.

Atributos

OverloadAttribute RemoteAsyncAttribute

Comentarios

Puede obtener una colección de pares clave-valor que puede pasar al parámetro encodingOptions mediante la creación de un nuevo BitmapPropertySet.

Vea CreateAsync(Guid, IRandomAccessStream, IIterable(IKeyValuePair)) para obtener más información sobre el uso de opciones de codificación.

Consulte también

• BitmapPropertySet
• GoToNextFrameAsync()