Partager via


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