Metodo IAudioMeterInformation::GetChannelsPeakValues (endpointvolume.h)
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 |
---|---|
|
Il parametro u32ChannelCount non è uguale al numero di canali nel flusso audio. |
|
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 |