_AM_AUDIO_RENDERER_STAT_PARAM enumeration (strmif.h)

The _AM_AUDIO_RENDERER_STAT_PARAM enumeration specifies which performance information to retrieve from the audio renderer.

This enumeration type is used in the IAMAudioRendererStats::GetStatParam method. Each enumeration member defines the meaning of the values that are returned in the pdwParam1 and pdwParam2 parameters of GetStatParam.

Note

Bias-free Communication Microsoft supports a diverse and inclusionary environment. Within this document, there are references to the word 'slave.' Microsoft's Style Guide for Bias-Free Communications recognizes this as an exclusionary word. This wording is used as it is currently the wording used within the software. For consistency, this document contains this word. When this word is removed from the software, we will correct this document to be in alignment.

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
} ;

Constants

 
AM_AUDREND_STAT_PARAM_BREAK_COUNT
Value: 1
Param1: The cumulative number of breaks in the audio stream.

Param2: Not used.
AM_AUDREND_STAT_PARAM_SLAVE_MODE
Param1: Indicates the current rate-matching mode. The value is a bitwise combination of the following:


  • 0x00: No rate matching.

  • 0x01: Match rates to a live source.

  • 0x02: Match rates based on the rate of the incoming audio data.

  • 0x04: Match rates with the filter graph's reference clock (when the clock is not provided by the audio renderer).

  • 0x10: Match rates based on the time stamps of the audio samples.


Param2: Not used.
AM_AUDREND_STAT_PARAM_SILENCE_DUR
Param1: The cumulative amount of silence the audio renderer has inserted, due to gaps in the time stamps of the incoming samples. The value is given in milliseconds.

Param2: Not used.
AM_AUDREND_STAT_PARAM_LAST_BUFFER_DUR
Param1: The duration of the most recent audio buffer, in milliseconds.

Param2: Not used.
AM_AUDREND_STAT_PARAM_DISCONTINUITIES
Param1: The cumulative number of discontinuities in the audio stream.

Param2: Not used.
AM_AUDREND_STAT_PARAM_SLAVE_RATE
Param1: The sample rate that the audio renderer is matching, in samples per second.

Param2: Not used.

Valid only when the DirectSound Renderer is matching rates to another clock or a live source.
AM_AUDREND_STAT_PARAM_SLAVE_DROPWRITE_DUR
Param1: The amount of data dropped to stay in sync, in milliseconds.

Param2: Not used.

Applies only when the Audio Renderer (WaveOut) filter is matching rates to a master clock.
AM_AUDREND_STAT_PARAM_SLAVE_HIGHLOWERROR
Param1: The highest difference noted between the audio renderer's clock and the clock it is trying to match.

Param2: The lowest difference noted between the audio renderer's clock and the clock it is trying to match.

Valid only when the audio renderer is matching rates to a master clock.
AM_AUDREND_STAT_PARAM_SLAVE_LASTHIGHLOWERROR
Param1: The last high error, in milliseconds. A high error occurs when the audio renderer falls behind the clock.

Param2: The last low error, in milliseconds. A low error occurs when the audio renderer runs ahead of the clock.

Valid only when the audio renderer is matching rates to a master clock.
AM_AUDREND_STAT_PARAM_SLAVE_ACCUMERROR
Param1: The accumulated difference between the audio renderer and the master clock, including adjustments made by dropping samples or inserting gaps.

Param2: Not used.

Valid only when the audio renderer is matching rates to another clock or a live source.
AM_AUDREND_STAT_PARAM_BUFFERFULLNESS
Param1: How much audio data is in the audio buffer, as a percentage.

Param2: Not used.
AM_AUDREND_STAT_PARAM_JITTER
Not implemented.

Requirements

   
Header strmif.h (include Dshow.h)

See also

DirectShow Enumerated Types

IAMAudioRendererStats Interface