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) |