Interfaccia FMSimpleAudioVolume (mfidl.h)

Controlla il livello di volume master della sessione audio associata al renderer audio di streaming (SAR) e all'origine di acquisizione audio.

La sar e l'origine di acquisizione audio espongono questa interfaccia come servizio. Per ottenere un puntatore all'interfaccia, chiamare IMFGetService::GetService. Per la SAR, usare l'identificatore del servizio MR_POLICY_VOLUME_SERVICE. Per l'origine dell'acquisizione audio, usare l'identificatore del servizio MR_CAPTURE_POLICY_VOLUME_SERVICE. È possibile chiamare GetService direttamente sulla sar o sull'origine di acquisizione audio oppure chiamarla nella sessione multimediale.

Ereditarietà

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

Metodi

L'interfaccia IMFSimpleAudioVolume include questi metodi.

FMSimpleAudioVolume::GetMasterVolume Recupera il livello del volume master.
FMSimpleAudioVolume::GetMute Esegue una query sul fatto che l'audio sia disattivato. (FMSimpleAudioVolume.GetMute)
FMSimpleAudioVolume::SetMasterVolume Imposta il livello del volume master.
FMSimpleAudioVolume::SetMute Disattiva o disattiva l'audio. (FMSimpleAudioVolume.SetMute)

Commenti

Per controllare i livelli di volume dei singoli canali, usare l'interfaccia FMAudioStreamVolume . L'interfaccia FMAudioStreamVolume è supportata solo dalla SAR.

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. Per modificare il livello di volume di singoli canali, usare l'interfaccia FMAudioStreamVolume .

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