Metodo IMFSinkWriter::Finalize (mfreadwrite.h)

Completa tutte le operazioni di scrittura sul writer sink.

Sintassi

HRESULT Finalize();

Valore restituito

Se questo metodo ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Commenti

Chiamare questo metodo dopo aver inviato tutti gli esempi di input al writer sink. Il metodo esegue tutte le operazioni necessarie per creare l'output finale dal sink multimediale.

Se si fornisce un'interfaccia di callback quando si crea il writer sink, questo metodo viene completato in modo asincrono. Al termine dell'operazione, viene chiamato il metodo FMSinkWriterCallback::OnFinalize del callback. Per altre informazioni, vedere MF_SINK_WRITER_ASYNC_CALLBACK. In caso contrario, se non si fornisce un callback, il metodo Finalize blocca fino al completamento dell'operazione.

Internamente, questo metodo chiama FMStreamSink::P laceMarker per inserire indicatori end-of-segment per ogni flusso nel sink multimediale. Chiama anche FMFinalizableMediaSink::BeginFinalize e EndFinalize se il sink multimediale supporta l'interfaccia FMFinalizableMediaSink .

Dopo aver chiamato questo metodo, i metodi seguenti avranno esito negativo:

Se non si chiama Finalize, l'output dal sink multimediale potrebbe essere incompleto o non valido. Ad esempio, le intestazioni di file necessarie potrebbero essere mancanti dal file di output.

Questa interfaccia è disponibile in Windows Vista se è installato l'aggiornamento della piattaforma per Windows Vista.

Requisiti

Requisito Valore
Client minimo supportato Supplemento per Windows 7, Windows Vista e Aggiornamento piattaforma per Windows Vista [app desktop | App UWP]
Server minimo supportato Windows Server 2008 R2 [app desktop | App UWP]
Piattaforma di destinazione Windows
Intestazione mfreadwrite.h

Vedi anche

FMSinkWriter

Sink Writer