Interfaccia FMAudioStreamVolume (mfidl.h)

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