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

Artigo
08/23/2023

O método GetLevelRange obtém o intervalo, em decibéis, do nível de volume do canal especificado.

Sintaxe

HRESULT GetLevelRange(
  [in]  UINT  nChannel,
  [out] float *pfMinLevelDB,
  [out] float *pfMaxLevelDB,
  [out] float *pfStepping
);

Parâmetros

[in] nChannel

O número do canal selecionado. Se o fluxo de áudio tiver n canais, os canais serão numerados de 0 a n– 1. Para obter o número de canais no fluxo, chame o método IPerChannelDbLevel::GetChannelCount .

[out] pfMinLevelDB

Ponteiro para uma variável float na qual o método grava o nível mínimo de volume em decibéis.

[out] pfMaxLevelDB

Ponteiro para uma variável float na qual o método grava o nível máximo de volume em decibéis.

[out] pfStepping

Ponteiro para uma variável float na qual o método grava o valor de etapa entre níveis de volume consecutivos no intervalo *pfMinLevelDB em *pfMaxLevelDB. Se a diferença entre os níveis de volume máximo e mínimo for d decibéis e o intervalo for dividido em n etapas (intervalos de tamanho uniforme), o volume poderá ter n + 1 níveis discretos e o tamanho da etapa entre níveis consecutivos será d / n decibels.

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_INVALIDARG	O parâmetro nChannel está fora do intervalo.
E_POINTER	O ponteiro pfminLevelDB, pfmaxLevelDB ou pfmaxLevelDB é NULL.

Requisitos

Requisito	Valor
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::GetChannelCount

Compartilhar via