Partager via


IAudioMeterInformation::GetPeakValue, méthode (endpointvolume.h)

La méthode GetPeakValue obtient la valeur d’exemple de pointe pour les canaux dans le flux audio.

Syntaxe

HRESULT GetPeakValue(
  [out] float *pfPeak
);

Paramètres

[out] pfPeak

Pointeur vers une variable float dans laquelle la méthode écrit la valeur maximale de l’exemple pour le flux audio. La valeur maximale est un nombre dans la plage normalisée comprise entre 0,0 et 1,0.

Valeur retournée

Si la méthode réussit, retourne S_OK. En cas d’échec, les codes de retour possibles incluent, sans s’y limiter, les valeurs indiquées dans le tableau suivant.

Code de retour Description
E_POINTER
Le paramètre pfPeak est NULL.

Notes

Cette méthode récupère la valeur maximale de l’échantillon enregistrée sur tous les canaux du flux. La valeur maximale de chaque canal est enregistrée sur une période d’appareil et mise à disposition pendant la période d’appareil suivante. Par conséquent, cette méthode récupère toujours la valeur maximale enregistrée au cours de la période précédente de l’appareil. Pour obtenir la période de l’appareil, appelez la méthode IAudioClient::GetDevicePeriod .

Pour obtenir un exemple de code qui utilise la méthode GetPeakValue , consultez Compteurs de pointe.

Spécifications

   
Client minimal pris en charge Windows Vista [applications de bureau | applications UWP]
Serveur minimal pris en charge Windows Server 2008 [applications de bureau | applications UWP]
Plateforme cible Windows
En-tête endpointvolume.h

Voir aussi

IAudioClient::GetDevicePeriod

IAudioMeterInformation, interface