CTransformFilter.GetMediaType, méthode

  • 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 in Media Foundation. Ces fonctionnalités ont été optimisées pour Windows 10 et Windows 11. Microsoft recommande vivement que le nouveau code utilise MediaPlayer, IMFMediaEngine et Audio/Video Capture dans Media Foundation au lieu de DirectShow, si 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 GetMediaType méthode récupère un type de média préféré pour l’épingle de sortie.

Syntaxe

virtual HRESULT GetMediaType(
   int        iPosition,
   CMediaType *pMediaType
) = 0;

Paramètres

iPosition

Valeur d’index de base zéro.

pMediaType

Pointeur vers un objet CMediaType qui reçoit le type de média.

Valeur renvoyée

Retourne une valeur HRESULT . Les valeurs possibles incluent celles indiquées dans le tableau suivant.

Code de retour Description
S_OK
 Opération réussie.
VFW_S_NO_MORE_ITEMS
 Index hors plage.
E_INVALIDARG
 Index inférieur à zéro.

Notes

La méthode CTransformOutputPin::GetMediaType de l’épingle de sortie appelle cette méthode. La classe dérivée doit implémenter cette méthode. Pour plus d’informations, consultez CBasePin::GetMediaType.

Configuration requise

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

Voir aussi

CTransformFilter, classe