Metodo IPerChannelDbLevel::GetLevelRange (devicetopology.h)

  • Articolo

Il metodo GetLevelRange ottiene l'intervallo, in decibel, del livello di volume del canale specificato.

Sintassi

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

Parametri

[in] nChannel

Numero del canale selezionato. Se il flusso audio ha n canali, i canali vengono numerati da 0 a n- 1. Per ottenere il numero di canali nel flusso, chiamare il metodo IPerChannelDbLevel::GetChannelCount .

[out] pfMinLevelDB

Puntatore a una variabile float in cui il metodo scrive il livello minimo di volume in decibel.

[out] pfMaxLevelDB

Puntatore a una variabile float in cui il metodo scrive il livello massimo di volume in decibel.

[out] pfStepping

Puntatore a una variabile float in cui il metodo scrive il valore di istruzione tra i livelli di volume consecutivi nell'intervallo *pfMinLevelDB in *pfMaxLevelDB. Se la differenza tra i livelli di volume massimo e minimo è d decibel e l'intervallo è diviso in n passaggi (intervalli di dimensioni uniformi), il volume può avere n + 1 livelli discreti e la dimensione del passaggio tra livelli consecutivi è d / n decibel.

Valore restituito

Se il metodo ha esito positivo, viene restituito S_OK. Se ha esito negativo, i possibili codici restituiti includono, ma non sono limitati, i valori illustrati nella tabella seguente.

Codice restituito Descrizione
E_INVALIDARG
 Il parametro nChannel non è compreso nell'intervallo.
E_POINTER
 Il puntatore pfminLevelDB, pfmaxLevelDB o pfmaxLevelDB è NULL.

Requisiti

Requisito Valore
Client minimo supportato Windows Vista [solo app desktop]
Server minimo supportato Windows Server 2008 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione devicetopology.h

Vedi anche

Interfaccia IPerChannelDbLevel

IPerChannelDbLevel::GetChannelCount