Share via

Interface IMFSampleOutputStream (mfobjects.h)

  • Article

Écrit des exemples multimédias dans un flux d’octets.

Héritage

L’interface IMFSampleOutputStream hérite de l’interface IUnknown. IMFSampleOutputStream a également les types de membres suivants :

Méthodes

L’interface IMFSampleOutputStream utilise ces méthodes.

 
IMFSampleOutputStream::BeginWriteSample

Commence une demande asynchrone pour écrire un exemple de média dans le flux.
IMFSampleOutputStream::EndWriteSample

Termine une demande asynchrone d’écriture d’un exemple de média dans le flux.

Notes

Un flux d’octets accessible en écriture peut éventuellement implémenter cette interface.

Cette interface permet à l’appelant d’envoyer des exemples multimédias au flux d’octets pour l’écriture, au lieu d’utiliser la méthode IMFByteStream::BeginWrite pour écrire des objets blob de données non typées. Le flux d’octets peut utiliser les informations contenues dans l’exemple multimédia pour optimiser la façon dont il écrit les données. Par exemple, un flux d’octets qui envoie des données multimédias sur un réseau peut être optimisé en fonction de l’horodatage.

Pour obtenir un pointeur vers cette interface, appelez QueryInterface sur l’objet de flux d’octets.

Toute implémentation de IMFByteStream qui expose IMFSampleOutputStream en tant qu’interface doit respecter les exigences suivantes :

  • Toutes les écritures de l’une ou l’autre interface vont toujours au même objet de flux d’octets.
  • La position actuelle pour IMFSampleOutputStream et IMFByteStream doit toujours être la même. Par exemple, l’écriture dans IMFSampleOutputStream met également à jour la position actuelle de IMFByteStream.
  • L’écriture d’un exemple à l’aide de BeginWriteSample et EndWriteSample sérialise l’exemple en écrivant les données de toutes les mémoires tampons de l’exemple, dans l’ordre dans lequel les mémoires tampons sont stockées dans l’exemple. (Utilisez IMFSample::GetBufferByIndex pour obtenir les mémoires tampons individuelles par valeur d’index.) Le nombre total d’octets copiés correspond au nombre d’octets écrits à partir de toutes les mémoires tampons.

Spécifications

   
Client minimal pris en charge Windows 8 [applications de bureau | Applications UWP]
Serveur minimal pris en charge Windows Server 2012 [applications de bureau | Applications UWP]
Plateforme cible Windows
En-tête mfobjects.h (include Mfidl.h)

Voir aussi

Interfaces Media Foundation