Metodo IAudioMeterInformation::GetChannelsPeakValues (endpointvolume.h)

Articolo
08/23/2023

Il metodo GetChannelsPeakValues ottiene i valori di esempio di picco per tutti i canali nel flusso audio.

Sintassi

HRESULT GetChannelsPeakValues(
  [in]  UINT32 u32ChannelCount,
  [out] float  *afPeakValues
);

Parametri

[in] u32ChannelCount

Conteggio dei canali. Questo parametro specifica anche il numero di elementi nella matrice afPeakValues . Se il conteggio specificato non corrisponde al numero di canali nel flusso, il metodo restituisce il codice di errore E_INVALIDARG.

[out] afPeakValues

Puntatore a una matrice di valori di esempio di picco. Il metodo scrive i valori di picco per i canali nella matrice. La matrice contiene un elemento per ogni canale nel flusso. I valori di picco sono numeri nell'intervallo normalizzato compreso tra 0,0 e 1,0.

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 u32ChannelCount non è uguale al numero di canali nel flusso audio.
E_POINTER	Il parametro afPeakValues è NULL.

Commenti

Questo metodo recupera i valori di esempio di picco per i canali nel flusso. Il valore di picco per ogni canale viene registrato in un periodo di dispositivo e reso disponibile durante il periodo successivo del dispositivo. Pertanto, questo metodo recupera sempre i valori di picco registrati durante il periodo precedente del dispositivo. Per ottenere il periodo del dispositivo, chiamare il metodo IAudioClient::GetDevicePeriod .

Il parametro afPeakValues punta a una matrice float allocata dal chiamante. Se il flusso contiene n canali, i canali vengono numerati da 0 a n- 1. Il metodo archivia il valore di picco per ogni canale nell'elemento della matrice il cui indice di matrice corrisponde al numero di canale. Per ottenere il numero di canali nel flusso audio monitorati dai contatori di picco, chiamare il metodo IAudioMeterInformation::GetMeteringChannelCount .

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista [app desktop \| App UWP]
Server minimo supportato	Windows Server 2008 [app desktop \| App UWP]
Piattaforma di destinazione	Windows
Intestazione	endpointvolume.h

Vedi anche

IAudioClient::GetDevicePeriod

Interfaccia IAudioMeterInformation

IAudioMeterInformation::GetMeteringChannelCount

Share via