Share via

Método IPerChannelDbLevel::SetLevelUniform (devicetopology.h)

  • Artigo

O método SetLevelUniform define todos os canais no fluxo de áudio para o mesmo nível de volume uniforme, em decibéis.

Sintaxe

HRESULT SetLevelUniform(
  [in] float   fLevelDB,
  [in] LPCGUID pguidEventContext
);

Parâmetros

[in] fLevelDB

O novo nível uniforme em decibéis.

[in] pguidEventContext

Valor de contexto para o método IControlChangeNotify::OnNotify . Esse parâmetro aponta para um GUID de contexto de evento. Se a chamada SetLevelUniform alterar o estado do controle de nível, todos os clientes que registraram interfaces IControlChangeNotify com esse controle 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, 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

Se o nível uniforme especificado estiver além do intervalo que o método IPerChannelDbLevel::GetLevelRange relata para um canal específico, a chamada SetLevelUniform fixará o valor desse canal no intervalo com suporte e será concluída com êxito. Uma chamada subsequente para o método IPerChannelDbLevel::GetLevel recupera o valor real usado para esse canal.

Requisitos

   
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

Confira também

IPerChannelDbLevel Interface

IPerChannelDbLevel::GetLevel

IPerChannelDbLevel::GetLevelRange