Interface IMFAudioStreamVolume (mfidl.h)

  • Artigo

Controla os níveis de volume de canais de áudio individuais.

O SAR (renderizador de áudio de streaming) expõe essa interface como um serviço. Para obter um ponteiro para a interface, chame IMFGetService::GetService com o identificador de serviço MR_STREAM_VOLUME_SERVICE. Você pode chamar GetService diretamente no SAR ou chamá-lo na Sessão de Mídia.

Herança

A interface IMFAudioStreamVolume herda da interface IUnknown . IMFAudioStreamVolume também tem estes tipos de membros:

Métodos

A interface IMFAudioStreamVolume tem esses métodos.

 
IMFAudioStreamVolume::GetAllVolumes

Recupera os níveis de volume para todos os canais no fluxo de áudio.
IMFAudioStreamVolume::GetChannelCount

Recupera o número de canais no fluxo de áudio.
IMFAudioStreamVolume::GetChannelVolume

Recupera o nível de volume de um canal especificado no fluxo de áudio.
IMFAudioStreamVolume::SetAllVolumes

Define os níveis de volume individuais para todos os canais no fluxo de áudio.
IMFAudioStreamVolume::SetChannelVolume

Define o nível de volume de um canal especificado no fluxo de áudio.

Comentários

Se o aplicativo não exigir controle de volume no nível do canal, você poderá usar a interface IMFSimpleAudioVolume para controlar o nível de volume master da sessão de áudio.

O volume é expresso como um nível de atenuação, em que 0,0 indica silêncio e 1,0 indica volume completo (sem atenuação). Para cada canal, o nível de atenuação é o produto de:

  • O master nível de volume da sessão de áudio.
  • O nível de volume do canal.
Por exemplo, se o volume master for 0,8 e o volume do canal for 0,5, a atenuação desse canal será 0,8 × 0,5 = 0,4. Os níveis de volume podem exceder 1,0 (ganho positivo), mas o mecanismo de áudio corta todos os exemplos de áudio que excedem zero decibéis.

Use a seguinte fórmula para converter o nível de volume na escala de decibéis (dB):

Atenuação (dB) = 20 * log10(Level)

Por exemplo, um nível de volume de 0,50 representa 6,02 dB de atenuação.

Requisitos

   
Cliente mínimo com suporte Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2008 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho mfidl.h

Confira também

Media Foundation Interfaces

Renderizador de áudio de streaming