Fonction MFCreateSampleCopierMFT (mfidl.h)

  • Article

Crée une instance de l’exemple de transformation du copieur.

Syntaxe

HRESULT MFCreateSampleCopierMFT(
  [out] IMFTransform **ppCopierMFT
);

Paramètres

[out] ppCopierMFT

Reçoit un pointeur vers l’interface IMFTransform . L’appelant doit libérer l’interface.

Valeur retournée

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

Notes

L’exemple de copieur est une transformation Media Foundation (MFT) qui copie les données des exemples d’entrée vers des exemples de sortie sans modifier les données. Les données suivantes sont copiées à partir de l’exemple :

  • Tous les exemples d’attributs.
  • Horodatage et durée.
  • Exemples d’indicateurs (voir IMFSample::SetSampleFlags).
  • Données dans les mémoires tampons multimédias. Si l’exemple d’entrée contient plusieurs mémoires tampons, les données sont copiées dans une seule mémoire tampon sur l’exemple de sortie.
Ce MFT est utile dans la situation suivante :
  • Un objet pipeline, tel qu’une source multimédia, alloue des exemples de média pour la sortie.
  • Un autre objet de pipeline, tel qu’un récepteur multimédia, alloue ses propres exemples de média pour l’entrée. Par exemple, l’objet peut nécessiter des mémoires tampons allouées à partir d’un pool de mémoires spécial, comme la mémoire vidéo.
Le diagramme suivant illustre cette situation avec une source multimédia et un récepteur multimédia. Diagramme : La source du média pointe vers un exemple ; Le récepteur multimédia pointe vers un deuxième exemple ; L’exemple de copieur pointe vers une flèche du premier échantillon au deuxième

Pour que le récepteur multimédia reçoive des données de la source multimédia, les données doivent être copiées dans les exemples de média appartenant au récepteur multimédia. L’exemple de copieur peut être utilisé à cet effet.

Un exemple spécifique d’un tel récepteur multimédia est le convertisseur vidéo amélioré (EVR). L’EVR alloue des échantillons qui contiennent des mémoires tampons de surface Direct3D, de sorte qu’il ne peut pas recevoir d’exemples vidéo directement à partir d’une source multimédia. À compter de Windows 7, le chargeur de topologie gère automatiquement ce cas en insérant l’exemple de copieur entre la source du média et l’EVR.

Spécifications

   
Client minimal pris en charge Windows 7 [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2008 R2 [applications de bureau uniquement]
Plateforme cible Windows
En-tête mfidl.h
Bibliothèque Mf.lib
DLL Mf.dll

Voir aussi

Fonctions Media Foundation