Interfaccia FMAudioStreamVolume (mfidl.h)

  • Articolo

Controlla i livelli di volume dei singoli canali audio.

Il renderer audio di streaming (SAR) espone questa interfaccia come servizio. Per ottenere un puntatore all'interfaccia, chiamare IMFGetService::GetService con l'identificatore del servizio MR_STREAM_VOLUME_SERVICE. È possibile chiamare GetService direttamente sulla SAR o chiamarla nella sessione multimediale.

Ereditarietà

L'interfaccia FMAudioStreamVolume eredita dall'interfaccia IUnknown . FMAudioStreamVolume include anche questi tipi di membri:

Metodi

L'interfaccia FMAudioStreamVolume include questi metodi.

 
FMAudioStreamVolume::GetAllVolumes

Recupera i livelli di volume per tutti i canali nel flusso audio.
FMAudioStreamVolume::GetChannelCount

Recupera il numero di canali nel flusso audio.
FMAudioStreamVolume::GetChannelVolume

Recupera il livello di volume per un canale specificato nel flusso audio.
FMAudioStreamVolume::SetAllVolumes

Imposta i singoli livelli di volume per tutti i canali nel flusso audio.
FMAudioStreamVolume::SetChannelVolume

Imposta il livello del volume per un canale specificato nel flusso audio.

Commenti

Se l'applicazione non richiede il controllo del volume a livello di canale, è possibile usare l'interfaccia FMSimpleAudioVolume per controllare il livello del volume master della sessione audio.

Il volume viene espresso come livello di attenuazione, dove 0.0 indica il silenzio e 1.0 indica il volume completo (nessuna attenuazione). Per ogni canale, il livello di attenuazione è il prodotto di:

  • Livello del volume master della sessione audio.
  • Livello del volume del canale.
Ad esempio, se il volume master è 0,8 e il volume del canale è 0,5, l'attenuazione per tale canale è 0,8 × 0,5 = 0,4. I livelli di volume possono superare 1,0 (guadagno positivo), ma il motore audio clip tutti gli esempi audio che superano zero decibel.

Utilizzare la formula seguente per convertire il livello del volume nella scala decibel (dB):

Attenuazione (dB) = 20 * log10(Livello)

Ad esempio, un livello di volume pari a 0,50 rappresenta 6,02 dB di attenuazione.

Requisiti

   
Client minimo supportato Windows Vista [solo app desktop]
Server minimo supportato Windows Server 2008 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione mfidl.h

Vedi anche

Interfacce di Media Foundation

Streaming Audio Renderer