énumération _AM_AUDIO_RENDERER_STAT_PARAM (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 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’énumération _AM_AUDIO_RENDERER_STAT_PARAM spécifie les informations de performances à récupérer à partir du convertisseur audio.

Ce type d’énumération est utilisé dans la méthode IAMAudioRendererStats ::GetStatParam . Chaque membre d’énumération définit la signification des valeurs retournées dans les paramètres pdwParam1 et pdwParam2 de GetStatParam.

Notes

Communication sans biais Microsoft prend en charge un environnement diversifié et inclusionnaire. Dans ce document, il existe des références au mot « esclave ». Microsoft’s Style Guide for Bias-Free Communications reconnaît cela comme un mot d’exclusion. Ce libellé est utilisé comme il s’agit actuellement de la formulation utilisée dans le logiciel. Par souci de cohérence, ce document contient ce mot. Lorsque ce mot est supprimé du logiciel, nous allons corriger l’alignement de ce document.

Syntax

typedef enum _AM_AUDIO_RENDERER_STAT_PARAM {
  AM_AUDREND_STAT_PARAM_BREAK_COUNT = 1,
  AM_AUDREND_STAT_PARAM_SLAVE_MODE,
  AM_AUDREND_STAT_PARAM_SILENCE_DUR,
  AM_AUDREND_STAT_PARAM_LAST_BUFFER_DUR,
  AM_AUDREND_STAT_PARAM_DISCONTINUITIES,
  AM_AUDREND_STAT_PARAM_SLAVE_RATE,
  AM_AUDREND_STAT_PARAM_SLAVE_DROPWRITE_DUR,
  AM_AUDREND_STAT_PARAM_SLAVE_HIGHLOWERROR,
  AM_AUDREND_STAT_PARAM_SLAVE_LASTHIGHLOWERROR,
  AM_AUDREND_STAT_PARAM_SLAVE_ACCUMERROR,
  AM_AUDREND_STAT_PARAM_BUFFERFULLNESS,
  AM_AUDREND_STAT_PARAM_JITTER
} ;

Constantes

 
AM_AUDREND_STAT_PARAM_BREAK_COUNT
Valeur : 1
Param1 : nombre cumulé d’interruptions dans le flux audio.

Param2 : non utilisé.
AM_AUDREND_STAT_PARAM_SLAVE_MODE
Param1 : indique le mode de correspondance de taux actuel. La valeur est une combinaison au niveau du bit des éléments suivants :


  • 0x00 : aucune correspondance de taux.

  • 0x01 : faire correspondre les taux à une source dynamique.

  • 0x02 : correspondance des tarifs en fonction du taux des données audio entrantes.

  • 0x04 : correspondance des taux avec l’horloge de référence du graphe de filtre (lorsque l’horloge n’est pas fournie par le convertisseur audio).

  • 0x10 : correspondance des tarifs en fonction des horodatages des échantillons audio.


Param2 : non utilisé.
AM_AUDREND_STAT_PARAM_SILENCE_DUR
Param1 : quantité cumulée de silence que le convertisseur audio a inséré, en raison d’intervalles dans les horodatages des échantillons entrants. La valeur est donnée en millisecondes.

Param2 : non utilisé.
AM_AUDREND_STAT_PARAM_LAST_BUFFER_DUR
Param1 : durée de la mémoire tampon audio la plus récente, en millisecondes.

Param2 : non utilisé.
AM_AUDREND_STAT_PARAM_DISCONTINUITIES
Param1 : nombre cumulé de discontinuités dans le flux audio.

Param2 : non utilisé.
AM_AUDREND_STAT_PARAM_SLAVE_RATE
Param1 : taux d’échantillonnage correspondant au convertisseur audio, dans les exemples par seconde.

Param2 : non utilisé.

Valide uniquement lorsque le renderer DirectSound correspond à des taux à une autre horloge ou à une source dynamique.
AM_AUDREND_STAT_PARAM_SLAVE_DROPWRITE_DUR
Param1 : quantité de données supprimées pour rester synchronisées, en millisecondes.

Param2 : non utilisé.

S’applique uniquement lorsque le filtre De rendu audio (WaveOut) correspond aux taux d’une horloge master.
AM_AUDREND_STAT_PARAM_SLAVE_HIGHLOWERROR
Param1 : la différence la plus élevée notée entre l’horloge du convertisseur audio et l’horloge qu’il tente de faire correspondre.

Param2 : la différence la plus faible notée entre l’horloge du convertisseur audio et l’horloge qu’il tente de faire correspondre.

Valide uniquement lorsque le convertisseur audio correspond à une horloge master.
AM_AUDREND_STAT_PARAM_SLAVE_LASTHIGHLOWERROR
Param1 : dernière erreur élevée, en millisecondes. Une erreur élevée se produit lorsque le convertisseur audio est en retard.

Param2 : dernière erreur faible, en millisecondes. Une erreur faible se produit lorsque le convertisseur audio s’exécute avant l’horloge.

Valide uniquement lorsque le convertisseur audio correspond à une horloge master.
AM_AUDREND_STAT_PARAM_SLAVE_ACCUMERROR
Param1 : différence cumulée entre le convertisseur audio et l’horloge master, y compris les ajustements effectués en supprimant des échantillons ou en insérant des interstices.

Param2 : non utilisé.

Valide uniquement lorsque le convertisseur audio correspond à une autre horloge ou à une source dynamique.
AM_AUDREND_STAT_PARAM_BUFFERFULLNESS
Param1 : quantité de données audio dans la mémoire tampon audio, sous forme de pourcentage.

Param2 : non utilisé.
AM_AUDREND_STAT_PARAM_JITTER
Non implémenté.

Configuration requise

Condition requise Valeur
En-tête strmif.h (include Dshow.h)

Voir aussi

Types énumérés DirectShow

IAMAudioRendererStats Interface