Share via

IMFSinkWriter::Finalize-Methode (mfreadwrite.h)

  • Artikel

Schließt alle Schreibvorgänge für den Senkenschreiber ab.

Syntax

HRESULT Finalize();

Rückgabewert

Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

Rufen Sie diese Methode auf, nachdem Sie alle Eingabebeispiele an den Senkenschreiber gesendet haben. Die -Methode führt alle Vorgänge aus, die zum Erstellen der endgültigen Ausgabe der Mediensenke erforderlich sind.

Wenn Sie beim Erstellen des Senkenschreibers eine Rückrufschnittstelle bereitstellen, wird diese Methode asynchron abgeschlossen. Nach Abschluss des Vorgangs wird die IMFSinkWriterCallback::OnFinalize-Methode Ihres Rückrufs aufgerufen. Weitere Informationen finden Sie unter MF_SINK_WRITER_ASYNC_CALLBACK. Andernfalls wird die Finalize-Methode blockiert, wenn Sie keinen Rückruf bereitstellen, bis der Vorgang abgeschlossen ist.

Intern ruft diese Methode IMFStreamSink::P laceMarker auf, um Segmentendemarker für jeden Stream auf der Mediensenke zu platzieren. Außerdem wird IMFFinalizableMediaSink::BeginFinalize und EndFinalize aufgerufen, wenn die Mediensenke die IMFFinalizableMediaSink-Schnittstelle unterstützt.

Nachdem diese Methode aufgerufen wurde, schlagen die folgenden Methoden fehl:

Wenn Sie Finalize nicht aufrufen, ist die Ausgabe der Mediensenke möglicherweise unvollständig oder ungültig. Beispielsweise können erforderliche Dateiheader in der Ausgabedatei fehlen.

Diese Schnittstelle ist unter Windows Vista verfügbar, wenn die Plattformupdateergänzung für Windows Vista installiert ist.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 7, Windows Vista und Plattform-Update-Ergänzung für Windows Vista [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 R2 [Desktop-Apps | UWP-Apps]
Zielplattform Windows
Kopfzeile mfreadwrite.h

Weitere Informationen

IMFSinkWriter

Senkenschreiber