Método IAudioEndpointVolume::VolumeStepDown (endpointvolume.h)
O método VolumeStepDown diminui, por uma etapa, o nível de volume do fluxo de áudio que entra ou sai do dispositivo de ponto de extremidade de áudio.
Sintaxe
HRESULT VolumeStepDown(
[in] LPCGUID pguidEventContext
);
Parâmetros
[in] pguidEventContext
Valor de contexto para o método IAudioEndpointVolumeCallback::OnNotify . Esse parâmetro aponta para um GUID de contexto de evento. Se a chamada VolumeStepDown alterar o nível de volume do ponto de extremidade, todos os clientes que registraram interfaces IAudioEndpointVolumeCallback com esse ponto de extremidade receberão notificações. Em sua implementação do método OnNotify , um cliente pode inspecionar o GUID de contexto de evento para descobrir se ele ou outro cliente é a origem do evento de alteração de volume. Se o chamador fornecer um ponteiro NULL para esse parâmetro, o método de notificação do cliente receberá um ponteiro de contexto NULL .
Retornar valor
Se o método for bem-sucedido, retornará S_OK. Se falhar, os códigos de retorno possíveis incluem, mas não se limitam a, os valores mostrados na tabela a seguir.
| Código de retorno | Descrição |
|---|---|
|
Sem memória. |
Comentários
Para obter a etapa de volume atual e o número total de etapas no intervalo de volumes, chame o método IAudioEndpointVolume::GetVolumeStepInfo .
Se o nível de volume já estiver na etapa mais baixa no intervalo de volumes, a chamada para VolumeStepDown não terá efeito e retornará status código S_OK.
Intervalos sucessivos entre etapas adjacentes não representam necessariamente incrementos de volume uniformes em amplitude de sinal linear ou decibéis. No Windows Vista, VolumeStepDown define a relação do índice da etapa com o nível de volume (amplitude do sinal) para ser uma curva afilado em áudio. Observe que a forma da curva pode mudar em versões futuras do Windows. Para obter mais informações sobre curvas afilados em áudio, consulte Controles de volume em fita de áudio.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows Vista [aplicativos da área de trabalho | Aplicativos UWP] |
| Servidor mínimo com suporte | Windows Server 2008 [aplicativos da área de trabalho | Aplicativos UWP] |
| Plataforma de Destino | Windows |
| Cabeçalho | endpointvolume.h |
Confira também
IAudioEndpointVolume Interface
IAudioEndpointVolume::GetVolumeStepInfo