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

O método SetMute define o estado de ativação do fluxo de áudio que entra ou sai do dispositivo de ponto de extremidade de áudio.

Sintaxe

HRESULT SetMute(
  [in] BOOL    bMute,
  [in] LPCGUID pguidEventContext
);

Parâmetros

[in] bMute

O novo estado de mudo. Se bMute for TRUE, o método silenciará o fluxo. Se FALSE, o método desativa o mudo.

[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 SetMute alterar o estado de ativação 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 control-change. Se o chamador fornecer um ponteiro NULL para esse parâmetro, a rotina de notificação receberá o valor guid de contexto GUID_NULL.

Valor retornado

Se o método for bem-sucedido e o estado de mudo for alterado, o método retornará S_OK. Se o método for bem-sucedido e o novo estado de muting for o mesmo que o estado de muting anterior, o método retornará S_FALSE. Se o método 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 um exemplo de código que chama SetMute, consulte Controles de Volume de Ponto de Extremidade.

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

IAudioEndpointVolumeCallback Interface

IAudioEndpointVolumeCallback::OnNotify