IMFFinalizableMediaSink::BeginFinalize-Methode (mfidl.h)

  • Artikel

Benachrichtigt die Mediensenke, asynchron alle Schritte zu unternehmen, die sie zum Abschließen ihrer Aufgaben benötigt.

Syntax

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

Parameter

[in] pCallback

Zeiger auf die IMFAsyncCallback-Schnittstelle eines asynchronen Objekts. Der Aufrufer muss diese Schnittstelle implementieren.

[in] punkState

Zeiger auf die IUnknown-Schnittstelle eines Zustandsobjekts, das vom Aufrufer definiert wird. Dieser Parameter kann NULL sein. Sie können dieses Objekt verwenden, um Zustandsinformationen aufzunehmen. Das -Objekt wird an den Aufrufer zurückgegeben, wenn der Rückruf aufgerufen wird.

Rückgabewert

Die Methode gibt ein HRESULT zurück. Mögliches Werte (aber nicht die Einzigen) sind die in der folgenden Tabelle.

Rückgabecode BESCHREIBUNG
S_OK
 Die Methode wurde erfolgreich ausgeführt.

Hinweise

Viele Archivmediensenken verfügen über Schritte, die sie am Ende der Archivierung ausführen müssen, um ihre Dateivorgänge abzuschließen, z. B. das Aktualisieren des Headers (für einige Formate) oder das Leeren aller ausstehenden Schreibvorgänge auf den Datenträger. In einigen Fällen kann dies teure Vorgänge wie die Indizierung des Inhalts umfassen. BeginFinalize ist eine asynchrone Methode zum Initiieren endgültiger Aufgaben.

Wenn der Vorgang abgeschlossen ist, wird die IMFAsyncCallback::Invoke-Methode des Rückrufobjekts aufgerufen. Zu diesem Zeitpunkt sollte die Anwendung IMFFinalizableMediaSink::EndFinalize aufrufen, um die asynchrone Anforderung abzuschließen.

Anforderungen

   
Unterstützte Mindestversion (Client) Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile mfidl.h
Bibliothek Mfuuid.lib

Weitere Informationen

IMFFinalizableMediaSink