Interface IAMStats (control.h)

[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.]

L’interface IAMStats récupère les données de performances à partir du Gestionnaire de graphes de filtre. Les filtres peuvent utiliser cette interface pour enregistrer des données de performances.

Filtrer les développeurs : comme avec toutes les interfaces Filter Graph Manager, un filtre ne doit pas contenir de références sur cette interface, sinon il provoquera un nombre de références circulaire. Pour plus d’informations, consultez IBaseFilter ::JoinFilterGraph.

Héritage

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

Méthodes

L’interface IAMStats possède ces méthodes.

IAMStats ::AddValue La méthode AddValue enregistre une nouvelle valeur.
IAMStats ::get_Count La méthode get_Count récupère le nombre de statistiques.
IAMStats ::GetIndex La méthode GetIndex récupère l’index d’une statistique nommée ou en crée une.
IAMStats ::GetValueByIndex La méthode GetValueByIndex récupère une statistique, par index.
IAMStats ::GetValueByName La méthode GetValueByName récupère une statistique, par nom.
IAMStats ::Reset La méthode Reset réinitialise toutes les statistiques à zéro.

Remarques

Chaque statistique est définie par un nom et un index. Utilisez la méthode GetIndex pour rechercher l’index à partir du nom. Les valeurs sont toujours des types doubles . Les statistiques suivantes sont prédéfinies.

Nom	Description
RenderFile	Mesure le temps pris par chaque appel à IGraphBuilder ::RenderFile.
ConnectDirectInternal	Mesure le temps nécessaire pour connecter deux filtres.
Générer le cache du mappeur	Mesure le temps nécessaire pour mettre en cache les informations sur les filtres inscrits (utilisés par l’objet Filter Mapper ).
Catégorie de processus CategoryName	Mesure le temps nécessaire à la mise en cache des informations sur les filtres dans une catégorie particulière, où CategoryName est le nom convivial de la catégorie de filtre. (Voir Filtrer les catégories.)

 

Pour chacune de ces statistiques, les valeurs représentent le temps en millisecondes.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	control.h (include Dshow.h)

Voir aussi

IDispatch