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
E_OUTOFMEMORY
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

IAudioEndpointVolumeCallback Interface

IAudioEndpointVolumeCallback::OnNotify