IAudioMeterInformation::GetPeakValue-Methode (endpointvolume.h)

Die GetPeakValue-Methode ruft den Spitzenwert des Beispiels für die Kanäle im Audiodatenstrom ab.

Syntax

HRESULT GetPeakValue(
  [out] float *pfPeak
);

Parameter

[out] pfPeak

Zeiger auf eine float-Variable , in die die Methode den Spitzenwert des Beispiels für den Audiodatenstrom schreibt. Der Spitzenwert ist eine Zahl im normalisierten Bereich von 0,0 bis 1,0.

Rückgabewert

Wenn die Methode erfolgreich ist, wird S_OK zurückgegeben. Wenn ein Fehler auftritt, umfassen mögliche Rückgabecodes die in der folgenden Tabelle gezeigten Werte, sind jedoch nicht darauf beschränkt.

Rückgabecode	Beschreibung
E_POINTER	Der Parameter pfPeak ist NULL.

Hinweise

Diese Methode ruft den Spitzenwert der Stichprobe ab, der über alle Kanäle im Stream aufgezeichnet wird. Der Spitzenwert für jeden Kanal wird über einen Gerätezeitraum aufgezeichnet und während des nachfolgenden Gerätezeitraums zur Verfügung gestellt. Daher ruft diese Methode immer den Spitzenwert ab, der während des vorherigen Gerätezeitraums aufgezeichnet wurde. Rufen Sie zum Abrufen des Gerätezeitraums die IAudioClient::GetDevicePeriod-Methode auf .

Ein Codebeispiel, das die GetPeakValue-Methode verwendet, finden Sie unter Peak Meter.

Anforderungen

Unterstützte Mindestversion (Client)	Windows Vista [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [Desktop-Apps | UWP-Apps]
Zielplattform	Windows
Kopfzeile	endpointvolume.h

Weitere Informationen

IAudioClient::GetDevicePeriod

IAudioMeterInformation-Schnittstelle