Méthode IMFFinalizableMediaSink::BeginFinalize (mfidl.h)
Avertit le récepteur multimédia d’effectuer de manière asynchrone toutes les étapes dont il a besoin pour terminer ses tâches.
Syntaxe
HRESULT BeginFinalize(
[in] IMFAsyncCallback *pCallback,
[in] IUnknown *punkState
);
Paramètres
[in] pCallback
Pointeur vers l’interface IMFAsyncCallback d’un objet asynchrone. L’appelant doit implémenter cette interface.
[in] punkState
Pointeur vers l’interface IUnknown d’un objet d’état, défini par l’appelant. Ce paramètre peut être NULL. Vous pouvez utiliser cet objet pour stocker des informations d’état. L’objet est retourné à l’appelant lorsque le rappel est appelé.
Valeur retournée
Cette méthode retourne un code HRESULT. Les valeurs possibles sont notamment celles figurant dans le tableau suivant.
| Code de retour | Description |
|---|---|
|
S_OK |
Notes
De nombreux récepteurs multimédias d’archive doivent effectuer des étapes à la fin de l’archivage pour terminer leurs opérations de fichier, telles que la mise à jour de l’en-tête (pour certains formats) ou le vidage de toutes les écritures en attente sur le disque. Dans certains cas, cela peut inclure des opérations coûteuses telles que l’indexation du contenu. BeginFinalize est un moyen asynchrone d’initier des tâches finales.
Une fois l’opération de finalisation terminée, la méthode IMFAsyncCallback::Invoke de l’objet de rappel est appelée. À ce stade, l’application doit appeler IMFFinalizableMediaSink::EndFinalize pour terminer la demande asynchrone.
Spécifications
| Client minimal pris en charge | Windows Vista [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows Server 2008 [applications de bureau uniquement] |
| Plateforme cible | Windows |
| En-tête | mfidl.h |
| Bibliothèque | Mfuuid.lib |