IAudioEndpointVolume (endpointvolume.h) – aplicatii Win32

• 12/05/2018
• 6 minute de citit

In acest articol

IAudioEndpointVolume Interfata reprezinta comenzile de volum de pe fluxul audio sau de la un dispozitiv audio punct final. Un client obtine o referinta la interfata IAudioEndpointVolume a unui dispozitiv de endpoint apeland metoda IMMDevice :: Activate cu parametrul iid setat la REFIID IID_IAudioEndpointVolume.

Aplicatiile audio care utilizeaza API-ul MMDevice si WASAPI utilizeaza de obicei interfata ISimpleAudioVolume pentru a gestiona nivelurile volumului fluxului pe sesiune. In cazuri rare, o aplicatie audio specializata ar putea necesita utilizarea interfetei IAudioEndpointVolume pentru a controla nivelul de volum master al unui dispozitiv audio final. Un client al IAudioEndpointVolume trebuie sa aiba grija sa evite efectele potential perturbatoare asupra altor aplicatii audio ale modificarii nivelurilor de volum master ale dispozitivelor audio endpoint. De obicei, utilizatorul are control exclusiv asupra nivelurilor de volum master prin intermediul programului de control al volumului Windows, Sndvol.exe.

Daca dispozitivul adaptor care transmite date audio catre sau de la dispozitivul terminal are controale de volum hardware si de dezactivare, interfata IAudioEndpointVolume foloseste acele controale pentru a gestiona volumul si dezactiva setarile fluxului audio. Daca dispozitivului audio ii lipseste un control al volumului hardware pentru flux, motorul audio implementeaza automat comenzile de volum si de dezactivare in software.

Pentru aplicatiile care gestioneaza fluxuri in mod partajat catre si de la dispozitive endpoint, comportamentul IAudioEndpointVolume este diferit pentru redarea fluxurilor si captarea fluxurilor.

Pentru un flux de redare mod partajat, controlul volumului punct final pe care clientul acceseaza prin intermediul IAudioEndpointVolume interfata functioneaza independent de comenzile de volum per sesiune ca ISimpleAudioVolume interfetele si punerea in aplicare a IChannelAudioVolume. Astfel, nivelul volumului fluxului de redare rezulta din efectele combinate ale controlului volumului punctului final si al controalelor pe sesiune.

Pentru un flux de captare mod partajat, per-sesiune de control al volumului ca ISimpleAudioVolume si IChannelAudioVolume interfetele puse in aplicare sunt direct legate de controlul volumului punct final implementat de IAudioEndpointVolume interfata. Schimbarea de control al volumului pe sesiune , prin metodele din ISimpleAudioVolume si IChannelAudioVolume interfetele modifica setarea de IAudioEndpointVolume de control al volumului interfetei, iar reversul este adevarat. Nivelurile de volum reprezentate de fiecare dintre interfete corespund reciproc dupa cum urmeaza:

• Pentru fiecare canal dintr-un flux, IAudioEndpointVolume ofera niveluri de volum conice audio exprimate in decibeli (dB), care sunt mapate la valori normalizate in intervalul de la 0,0 (volum minim) la 1,0 (volum maxim). Intervalul posibil depinde de driverul audio. Consultati IAudioEndpointVolume :: GetVolumeRange pentru detalii.
• Volumul sesiunii reprezentat de ISimpleAudioVolume :: GetMasterVolume este valoarea scalara cuprinsa intre 0,0 si 1,0, care corespunde celei mai mari setari de volum pe diferite canale. De exemplu, daca canalul din stanga este setat la 0,8, iar canalul din dreapta este setat la 0,4, atunci ISimpleAudioVolume :: GetMasterVolume va intoarce 0,8.
• Cand nivelul de volum per-canal este controlat prin metodele din interfata IChannelAudioVolume, volumul de indicare scalar este intotdeauna relativ la volumul sesiunii. Aceasta inseamna ca canalul sau canalele cu cel mai mare volum are un volum de 1,0. Avand in vedere exemplul a doua canale, setat la volume de 0,8 si 0,4 de IAudioEndpointVolume :: SetChannelVolumeLevelScalar, IChannelAudioVolume :: GetChannelVolume va indica volume de 1,0 si 0,5.

Nota   Clientii API-ului EndpointVolume nu ar trebui sa se bazeze pe comportamentul precedent, deoarece s-ar putea schimba in versiunile viitoare.

Daca un dispozitiv are volume hardware si comenzi de dezactivare a sunetului, modificarile aduse setarilor de volum si dezactivare a dispozitivului prin interfata IAudioEndpointVolume afecteaza nivelul volumului atat in ​​modul partajat, cat si in modul exclusiv. Daca unui dispozitiv ii lipseste volumul hardware si controalele de dezactivare a sunetului, modificarile aduse controlului de volum si dezactivare a software-ului prin interfata IAudioEndpointVolume afecteaza nivelul volumului in modul partajat, dar nu si in modul exclusiv. In modul exclusiv, clientul si dispozitivul schimba direct date audio, ocolind comenzile software. Cu toate acestea, controalele software sunt persistente, iar modificarile de volum efectuate in timp ce dispozitivul functioneaza in modul exclusiv intra in vigoare atunci cand dispozitivul trece la modul de partajare.

Pentru a determina daca un dispozitiv are controale de volum hardware si de dezactivare a sunetului, apelati metoda IAudioEndpointVolume :: QueryHardwareSupport.

Metodele interfetei IAudioEndpointVolume permit clientului sa exprime nivelurile de volum fie in decibeli, fie ca valori normalizate, conice audio. In acest din urma caz, un nivel de volum este exprimat ca o valoare in virgula mobila in intervalul normalizat de la 0,0 (volum minim) la 1,0 (volum maxim). In acest interval, relatia nivelului de volum normalizat cu atenuarea amplitudinii semnalului este descrisa printr-o curba neliniara, audio-conica. Pentru mai multe informatii despre curbele conice audio, consultati Controalele volumului audio conice.

In plus, pentru a suporta in mod convenabil glisorii de volum in interfetele utilizator, interfata IAudioEndpointVolume permite clientilor sa seteze si sa obtina niveluri de volum care sunt exprimate ca valori discrete sau „pasi”. Etapele sunt distribuite uniform pe o curba neliniara, audio-conica. Daca intervalul contine n pasi, pasii sunt numerotati de la 0 la n – 1, unde pasul 0 reprezinta nivelul minim al volumului si pasul n – 1 reprezinta maximul.

Pentru un exemplu de cod care utilizeaza interfata IAudioEndpointVolume , consultati Controlul volumului punctului final.

Mostenire

De IAudioEndpointVolume mosteneste de interfata din interfata IUnknown. IAudioEndpointVolume are, de asemenea, aceste tipuri de membri:

• Metode

Metode

IAudioEndpointVolume Interfata are aceste metode.

  IAudioEndpointVolume :: GetChannelCount

Metoda GetChannelCount obtine un numar de canale din fluxul audio care intra sau iese din dispozitivul audio final.

IAudioEndpointVolume :: GetChannelVolumeLevel

Metoda GetChannelVolumeLevel obtine nivelul volumului, in decibeli, al canalului specificat in fluxul audio care intra sau iese din dispozitivul audio final.

IAudioEndpointVolume :: GetChannelVolumeLevelScalar

Metoda GetChannelVolumeLevelScalar obtine nivelul de volum normalizat, conic audio al canalului specificat al fluxului audio care intra sau iese din dispozitivul audio final.

IAudioEndpointVolume :: GetMasterVolumeLevel

Metoda GetMasterVolumeLevel obtine nivelul principal de volum, in decibeli, al fluxului audio care intra sau iese din dispozitivul audio final.

IAudioEndpointVolume :: GetMasterVolumeLevelScalar

Metoda GetMasterVolumeLevelScalar obtine nivelul de volum principal al fluxului audio care intra sau iese din dispozitivul audio final. Nivelul volumului este exprimat ca o valoare normalizata, conica audio, in intervalul de la 0,0 la 1,0.

IAudioEndpointVolume :: GetMute

Metoda GetMute obtine starea de mutare a fluxului audio care intra sau iese din dispozitivul audio final.

IAudioEndpointVolume :: GetVolumeRange

Metoda GetVolumeRange obtine intervalul de volum, in decibeli, al fluxului audio care intra sau iese din dispozitivul audio final.

IAudioEndpointVolume :: GetVolumeStepInfo

Metoda GetVolumeStepInfo primeste informatii despre pasul curent din intervalul de volum.

IAudioEndpointVolume :: QueryHardwareSupport

Metoda QueryHardwareSupport interoga dispozitivul audio final pentru functiile sale acceptate de hardware.

IAudioEndpointVolume :: RegisterControlChangeNotify

Metoda RegisterControlChangeNotify inregistreaza interfata de apelare a notificarii unui client.

IAudioEndpointVolume :: SetChannelVolumeLevel

Metoda SetChannelVolumeLevel stabileste nivelul volumului, in decibeli, al canalului specificat al fluxului audio care intra sau iese din dispozitivul audio final.

IAudioEndpointVolume :: SetChannelVolumeLevelScalar

Metoda SetChannelVolumeLevelScalar seteaza nivelul de volum normalizat, conic audio al canalului specificat in fluxul audio care intra sau iese din dispozitivul audio final.

IAudioEndpointVolume :: SetMasterVolumeLevel

Metoda SetMasterVolumeLevel stabileste nivelul volumului master, in decibeli, al fluxului audio care intra sau iese din dispozitivul audio final.

IAudioEndpointVolume :: SetMasterVolumeLevelScalar

Metoda SetMasterVolumeLevelScalar seteaza nivelul de volum principal al fluxului audio care intra sau iese din dispozitivul audio final. Nivelul volumului este exprimat ca o valoare normalizata, conica audio, in intervalul de la 0,0 la 1,0.

IAudioEndpointVolume :: SetMute

Metoda SetMute seteaza starea de mutare a fluxului audio care intra sau iese din dispozitivul audio final.

IAudioEndpointVolume :: UnregisterControlChangeNotify

Metoda UnregisterControlChangeNotify sterge inregistrarea interfetei de apelare de notificare a unui client pe care clientul a inregistrat-o intr-un apel anterior la metoda IAudioEndpointVolume :: RegisterControlChangeNotify.

IAudioEndpointVolume :: VolumeStepDown

Metoda VolumeStepDown scade, cu un pas, nivelul volumului fluxului audio care intra sau iese din dispozitivul audio final.

IAudioEndpointVolume :: VolumeStepUp

Metoda VolumeStepUp mareste, cu un pas, nivelul de volum al fluxului audio care intra sau iese din dispozitivul audio final.

Cerinte

    Windows Vista client minim acceptat [aplicatii desktop | Aplicatii UWP] Server minim acceptat Windows Server 2008 [aplicatii desktop | Aplicatii UWP] Target Platform Windows Header endpointvolume.h

Vezi si

Interfete audio de baza

API EndpointVolume

IMMDevice :: Activare

ISimpleAudioVolume Interface