Fonction CopyMediaType

  • Article

[La fonctionnalité associée à cette page, DirectShow, est une fonctionnalité héritée. Il a été remplacé par MediaPlayer, IMFMediaEngine et Audio/Video Capture dans Media Foundation. Ces fonctionnalités ont été optimisées pour Windows 10 et Windows 11. Microsoft recommande vivement au nouveau code d’utiliser MediaPlayer, IMFMediaEngine et La capture audio/vidéo dans Media Foundation au lieu de DirectShow, lorsque cela est possible. Microsoft suggère que le code existant qui utilise les API héritées soit réécrit pour utiliser les nouvelles API si possible.]

La fonction CopyMediaType copie une structure AM_MEDIA_TYPE dans une autre structure, y compris le bloc de format

Syntaxe

HRESULT WINAPI CopyMediaType(
         AM_MEDIA_TYPE *pmtTarget,
   const AM_MEDIA_TYPE *pmtSource
);

Paramètres

pmtTarget

Pointeur vers une structure AM_MEDIA_TYPE . La méthode copie le type de média dans cette structure.

pmtSource

Pointeur vers une structure source AM_MEDIA_TYPE à copier.

Valeur renvoyée

Retourne S_OK ou E_OUTOFMEMORY.

Notes

Cette fonction alloue la mémoire pour le bloc de format. Si le paramètre pmtTarget contient déjà un bloc de format alloué, une fuite de mémoire se produit. Pour éviter une fuite de mémoire, appelez FreeMediaType avant d’appeler cette fonction.

Une fois la méthode retournée, appelez FreeMediaType sur pmtTarget pour libérer le bloc de format.

Configuration requise

Condition requise Valeur
En-tête
Mtype.h (include Streams.h)
Bibliothèque
Strmbase.lib (builds de vente au détail) ;
Strmbasd.lib (builds de débogage)

Voir aussi

Fonctions de type multimédia