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

  • Article

Termine toutes les opérations d’écriture sur l’enregistreur récepteur.

Syntaxe

HRESULT Finalize();

Valeur retournée

Si cette méthode réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.

Remarques

Appelez cette méthode après avoir envoyé tous les exemples d’entrée au writer récepteur. La méthode effectue toutes les opérations nécessaires pour créer la sortie finale à partir du récepteur multimédia.

Si vous fournissez une interface de rappel lorsque vous créez l’enregistreur récepteur, cette méthode se termine de manière asynchrone. Une fois l’opération terminée, la méthode IMFSinkWriterCallback ::OnFinalize de votre rappel est appelée. Pour plus d’informations, consultez MF_SINK_WRITER_ASYNC_CALLBACK. Sinon, si vous ne fournissez pas de rappel, la méthode Finalize se bloque jusqu’à ce que l’opération se termine.

En interne, cette méthode appelle IMFStreamSink ::P laceMarker pour placer des marqueurs de fin de segment pour chaque flux sur le récepteur multimédia. Il appelle également IMFFinalizableMediaSink ::BeginFinalize et EndFinalize si le récepteur multimédia prend en charge l’interface IMFFinalizableMediaSink .

Une fois cette méthode appelée, les méthodes suivantes échouent :

Si vous n’appelez pas Finalize, la sortie du récepteur multimédia peut être incomplète ou non valide. Par exemple, les en-têtes de fichier requis peuvent être manquants dans le fichier de sortie.

Cette interface est disponible sur Windows Vista si le Supplément de mise à jour de la plateforme pour Windows Vista est installé.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 7, Windows Vista et supplément de mise à jour de plateforme pour Windows Vista [applications de bureau | Applications UWP]
Serveur minimal pris en charge Windows Server 2008 R2 [applications de bureau | Applications UWP]
Plateforme cible Windows
En-tête mfreadwrite.h

Voir aussi

IMFSinkWriter

Enregistreur de récepteurs