Compartilhar via


Método IMFSinkWriter::Finalize (mfreadwrite.h)

Conclui todas as operações de gravação no gravador do coletor.

Sintaxe

HRESULT Finalize();

Retornar valor

Se o método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Comentários

Chame esse método depois de enviar todos os exemplos de entrada para o gravador do coletor. O método executa todas as operações necessárias para criar a saída final do coletor de mídia.

Se você fornecer uma interface de retorno de chamada ao criar o gravador do coletor, esse método será concluído de forma assíncrona. Quando a operação for concluída, o método IMFSinkWriterCallback::OnFinalize do retorno de chamada será chamado. Para obter mais informações, consulte MF_SINK_WRITER_ASYNC_CALLBACK. Caso contrário, se você não fornecer um retorno de chamada, o método Finalize será bloqueado até que a operação seja concluída.

Internamente, esse método chama IMFStreamSink::P laceMarker para colocar marcadores de fim de segmento para cada fluxo no coletor de mídia. Ele também chamará IMFFinalizableMediaSink::BeginFinalize e EndFinalize se o coletor de mídia der suporte à interface IMFFinalizableMediaSink .

Depois que esse método for chamado, os seguintes métodos falharão:

Se você não chamar Finalizar, a saída do coletor de mídia poderá estar incompleta ou inválida. Por exemplo, os cabeçalhos de arquivo necessários podem estar ausentes do arquivo de saída.

Essa interface estará disponível no Windows Vista se o Suplemento de Atualização de Plataforma para Windows Vista estiver instalado.

Requisitos

Requisito Valor
Cliente mínimo com suporte Suplemento Windows 7, Windows Vista e Platform Update para Windows Vista [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo com suporte Windows Server 2008 R2 [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino Windows
Cabeçalho mfreadwrite.h

Confira também

IMFSinkWriter

Gravador de Coletor