Compartilhar via


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

Notifica o coletor de mídia para executar de forma assíncrona todas as etapas necessárias para concluir suas tarefas.

Sintaxe

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

Parâmetros

[in] pCallback

Ponteiro para a interface IMFAsyncCallback de um objeto assíncrono. O chamador deve implementar essa interface.

[in] punkState

Ponteiro para a interface IUnknown de um objeto de estado, definido pelo chamador. Este parâmetro pode ser NULL. Você pode usar esse objeto para armazenar informações de estado. O objeto é retornado ao chamador quando o retorno de chamada é invocado.

Valor retornado

O método retorna um HRESULT. Os possíveis valores incluem, mas sem limitação, aqueles na tabela a seguir.

Código de retorno Descrição
S_OK
O método foi bem-sucedido.

Comentários

Muitos coletores de mídia de arquivo morto têm etapas que precisam fazer no final do arquivamento para concluir suas operações de arquivo, como atualizar o cabeçalho (para alguns formatos) ou liberar todas as gravações pendentes no disco. Em alguns casos, isso pode incluir operações caras, como a indexação do conteúdo. BeginFinalize é uma maneira assíncrona de iniciar tarefas finais.

Quando a operação de finalização for concluída, o método IMFAsyncCallback::Invoke do objeto de retorno de chamada será chamado. Nesse ponto, o aplicativo deve chamar IMFFinalizableMediaSink::EndFinalize para concluir a solicitação assíncrona.

Requisitos

   
Cliente mínimo com suporte Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2008 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho mfidl.h
Biblioteca Mfuuid.lib

Confira também

IMFFinalizableMediaSink