Método IAudioEndpointVolume::VolumeStepUp (endpointvolume.h)

O método VolumeStepUp incrementa, em 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 VolumeStepUp(
  [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 VolumeStepUp 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 .

Valor retornado

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 volume, chame o método IAudioEndpointVolume::GetVolumeStepInfo .

Se o nível de volume já estiver na etapa mais alta no intervalo de volumes, a chamada para VolumeStepUp 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, VolumeStepUp define a relação do índice da etapa com o nível do volume (amplitude do sinal) como uma curva de áudio afilado. Observe que a forma da curva pode mudar em versões futuras do Windows. Para obter mais informações sobre curvas de áudio afilado, consulte Audio-Tapered Volume Controls.

Requisitos

   
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