Compartir a través de

Método IMFFinalizableMediaSink::BeginFinalize (mfidl.h)

  • Artículo

Notifica al receptor de medios que realice de forma asincrónica los pasos necesarios para finalizar sus tareas.

Sintaxis

HRESULT BeginFinalize(
  [in] IMFAsyncCallback *pCallback,
  [in] IUnknown         *punkState
);

Parámetros

[in] pCallback

Puntero a la interfaz IMFAsyncCallback de un objeto asincrónico. El autor de la llamada debe implementar esta interfaz.

[in] punkState

Puntero a la interfaz IUnknown de un objeto de estado, definido por el autor de la llamada. Este parámetro puede ser NULL. Puede usar este objeto para contener información de estado. El objeto se devuelve al autor de la llamada cuando se invoca la devolución de llamada.

Valor devuelto

El método devuelve un valor HRESULT. Entre los valores posibles se incluyen los que se indican en la tabla siguiente, entre otros.

Código devuelto Descripción
S_OK
 El método se ha llevado a cabo de forma correcta.

Comentarios

Muchos receptores de medios de archivo tienen pasos que deben realizar al final del archivado para completar sus operaciones de archivo, como actualizar el encabezado (para algunos formatos) o vaciar todas las escrituras pendientes en el disco. En algunos casos, esto puede incluir operaciones costosas, como la indexación del contenido. BeginFinalize es una manera asincrónica de iniciar tareas finales.

Una vez completada la operación de finalización, se llama al método IMFAsyncCallback::Invoke del objeto de devolución de llamada. En ese momento, la aplicación debe llamar a IMFFinalizableMediaSink::EndFinalize para completar la solicitud asincrónica.

Requisitos

   
Cliente mínimo compatible Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado mfidl.h
Library Mfuuid.lib

Consulte también

IMFFinalizableMediaSink