Méthode IPin ::EnumMediaTypes (strmif.h)

  • 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 méthode EnumMediaTypes énumère les types de média préférés de l’épingle.

Syntaxe

HRESULT EnumMediaTypes(
  [out] IEnumMediaTypes **ppEnum
);

Paramètres

[out] ppEnum

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

Valeur retournée

Retourne une valeur HRESULT . Les valeurs possibles sont les suivantes.

Code de retour Description
S_OK
 Réussite.
E_OUTOFMEMORY
 Mémoire insuffisante.
E_POINTER
 Argument pointeur NULL .
VFW_E_NOT_CONNECTED
 La broche n’est pas connectée. Certaines broches n’énumèrent pas les types de supports, sauf si l’épingle est connectée à un autre filtre.

Remarques

L’interface IEnumMediaTypes fonctionne comme un énumérateur COM standard. Pour plus d’informations, consultez Énumération d’objets dans un graphe de filtres. Si la méthode réussit, l’interface IEnumMediaTypes a un nombre de références exceptionnel. Veillez à le libérer lorsque vous avez terminé.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge Windows 2000 Server [applications de bureau uniquement]
Plateforme cible Windows
En-tête strmif.h (include Dshow.h)
Bibliothèque Strmiids.lib

Voir aussi

Data Flow dans le graphe de filtres

Codes d’erreur et de réussite

IPin Interface