Compartilhar via


enumeração _AM_AUDIO_RENDERER_STAT_PARAM (strmif.h)

[O recurso associado a esta página, DirectShow, é um recurso herdado. Foi substituído por MediaPlayer, IMFMediaEngine e Audio/Video Capture in Media Foundation. Esses recursos foram otimizados para Windows 10 e Windows 11. A Microsoft recomenda fortemente que o novo código use MediaPlayer, IMFMediaEngine e Audio/Video Capture in Media Foundation em vez de DirectShow, quando possível. A Microsoft sugere que o código existente que usa as APIs herdadas seja reescrito para usar as novas APIs, se possível.]

A enumeração _AM_AUDIO_RENDERER_STAT_PARAM especifica quais informações de desempenho recuperar do renderizador de áudio.

Esse tipo de enumeração é usado no método IAMAudioRendererStats::GetStatParam . Cada membro de enumeração define o significado dos valores retornados nos parâmetros pdwParam1 e pdwParam2 de GetStatParam.

Observação

Comunicação sem preconceitos A Microsoft dá suporte a um ambiente diversificado e incluso. Neste documento, há referências à palavra "subordinado". O Guia de Estilo da Microsoft para comunicações Bias-Free reconhece isso como uma palavra de exclusão. Essa redação é usada, pois é atualmente a redação usada dentro do software. Para consistência, este documento contém essa palavra. Quando essa palavra for removida do software, corrigiremos este documento para que ele esteja alinhado.

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
Valor: 1
Param1: o número cumulativo de quebras no fluxo de áudio.

Param2: não usado.
AM_AUDREND_STAT_PARAM_SLAVE_MODE
Param1: indica o modo de correspondência de taxa atual. O valor é uma combinação bit a bit do seguinte:


  • 0x00: nenhuma correspondência de taxa.

  • 0x01: corresponder as taxas a uma fonte dinâmica.

  • 0x02: corresponde às taxas com base na taxa dos dados de áudio de entrada.

  • 0x04: corresponde às taxas com o relógio de referência do grafo de filtro (quando o relógio não é fornecido pelo renderizador de áudio).

  • 0x10: corresponde às taxas com base nos carimbos de data/hora dos exemplos de áudio.


Param2: não usado.
AM_AUDREND_STAT_PARAM_SILENCE_DUR
Param1: a quantidade cumulativa de silêncio que o renderizador de áudio inseriu, devido a lacunas nos carimbos de data/hora dos exemplos de entrada. O valor é fornecido em milissegundos.

Param2: não usado.
AM_AUDREND_STAT_PARAM_LAST_BUFFER_DUR
Param1: a duração do buffer de áudio mais recente, em milissegundos.

Param2: não usado.
AM_AUDREND_STAT_PARAM_DISCONTINUITIES
Param1: o número cumulativo de descontinuidades no fluxo de áudio.

Param2: não usado.
AM_AUDREND_STAT_PARAM_SLAVE_RATE
Param1: a taxa de amostragem que o renderizador de áudio está correspondendo, em exemplos por segundo.

Param2: não usado.

Válido somente quando o Renderizador DirectSound está correspondendo taxas a outro relógio ou uma fonte dinâmica.
AM_AUDREND_STAT_PARAM_SLAVE_DROPWRITE_DUR
Param1: a quantidade de dados removidos para permanecer em sincronia, em milissegundos.

Param2: não usado.

Aplica-se somente quando o filtro Do Renderizador de Áudio (WaveOut) está correspondendo as taxas a um relógio master.
AM_AUDREND_STAT_PARAM_SLAVE_HIGHLOWERROR
Param1: a diferença mais alta observada entre o relógio do renderizador de áudio e o relógio que ele está tentando corresponder.

Param2: a menor diferença observada entre o relógio do renderizador de áudio e o relógio que ele está tentando corresponder.

Válido somente quando o renderizador de áudio estiver correspondendo as taxas a um relógio master.
AM_AUDREND_STAT_PARAM_SLAVE_LASTHIGHLOWERROR
Param1: o último erro alto, em milissegundos. Um erro alto ocorre quando o renderizador de áudio fica atrás do relógio.

Param2: o último erro baixo, em milissegundos. Um erro baixo ocorre quando o renderizador de áudio é executado antes do relógio.

Válido somente quando o renderizador de áudio estiver correspondendo as taxas a um relógio master.
AM_AUDREND_STAT_PARAM_SLAVE_ACCUMERROR
Param1: a diferença acumulada entre o renderizador de áudio e o relógio master, incluindo ajustes feitos ao descartar amostras ou inserir lacunas.

Param2: não usado.

Válido somente quando o renderizador de áudio estiver correspondendo as taxas a outro relógio ou a uma fonte dinâmica.
AM_AUDREND_STAT_PARAM_BUFFERFULLNESS
Param1: quantos dados de áudio estão no buffer de áudio, como uma porcentagem.

Param2: não usado.
AM_AUDREND_STAT_PARAM_JITTER
Não implementado.

Requisitos

Requisito Valor
Cabeçalho strmif.h (inclua Dshow.h)

Confira também

Tipos enumerados do DirectShow

IAMAudioRendererStats Interface