Interface IAudioVolumeLevel (devicetopology.h)

A interface IAudioVolumeLevel fornece acesso a um controle de volume de hardware. O cliente obtém uma referência à interface IAudioVolumeLevel de uma subunidade chamando o método IPart::Activate com refiid de parâmetro definido como REFIID IID_IAudioVolumeLevel. A chamada para IPart::Activate só terá êxito se a subunidade der suporte à interface IAudioVolumeLevel . Somente um objeto de subunidade que representa um controle de nível de volume de hardware dará suporte a essa interface.

A interface IAudioVolumeLevel fornece controles por canal para definir e obter os níveis de ganho ou atenuação no fluxo de áudio. Se um controle de hardware no nível do volume só puder atenuar os canais no fluxo de áudio, o nível máximo de volume para qualquer canal será 0 dB. Se um controle de nível de volume puder fornecer ganho (amplificação), o nível máximo de volume será maior que 0 dB.

A maioria dos drivers de adaptador de áudio do Windows dá suporte ao WDM (Modelo de Driver do Windows) e usa propriedades de KS (streaming de kernel) para representar os parâmetros de controle de hardware em subunidades (conhecidos como nós KS). A interface IAudioVolumeLevel fornece acesso conveniente à propriedade KSPROPERTY_AUDIO_VOLUMELEVEL de uma subunidade que tem um valor GUID de subtipo de KSNODETYPE_VOLUME. Para obter o GUID do subtipo de uma subunidade, chame o método IPart::GetSubType . Para obter mais informações sobre propriedades KS e tipos de nó KS, consulte a documentação do DDK do Windows.

Herança

A interface IAudioVolumeLevel herda da interface IPerChannelDbLevel.

Requisitos

Requisito	Valor
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	devicetopology.h

Confira também

Principais interfaces de áudio

DeviceTopology API

IPart::Activate

IPerChannelDbLevel Interface