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 |