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 |
|---|---|
|
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 |