IAudioMeterInformation::GetChannelsPeakValues-Methode (endpointvolume.h)

Die GetChannelsPeakValues-Methode ruft die Spitzenbeispielwerte für alle Kanäle im Audiodatenstrom ab.

Syntax

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

Parameter

[in] u32ChannelCount

Die Kanalanzahl. Dieser Parameter gibt auch die Anzahl der Elemente im afPeakValues-Array an . Wenn die angegebene Anzahl nicht mit der Anzahl der Kanäle im Stream übereinstimmt, gibt die Methode den Fehlercode E_INVALIDARG zurück.

[out] afPeakValues

Zeiger auf ein Array von Spitzenbeispielwerten. Die -Methode schreibt die Spitzenwerte für die Kanäle in das Array. Das Array enthält ein Element für jeden Kanal im Stream. Die Spitzenwerte sind Zahlen 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_INVALIDARG	Der Parameter u32ChannelCount entspricht nicht der Anzahl der Kanäle im Audiodatenstrom.
E_POINTER	Der Parameter afPeakValues ist NULL.

Hinweise

Diese Methode ruft die Spitzenstichprobenwerte für die Kanäle im Stream ab. 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 die Spitzenwerte ab, die während des vorherigen Gerätezeitraums aufgezeichnet wurden. Rufen Sie zum Abrufen des Gerätezeitraums die IAudioClient::GetDevicePeriod-Methode auf .

Der Parameter afPeakValues verweist auf ein vom Aufrufer zugeordnetes Floatarray . Wenn der Stream n Kanäle enthält, werden die Kanäle zwischen 0 und n– 1 nummeriert. Die -Methode speichert den Spitzenwert für jeden Kanal im Arrayelement, dessen Arrayindex mit der Kanalnummer übereinstimmt. Rufen Sie die IAudioMeterInformation::GetMeteringChannelCount-Methode auf, um die Anzahl der Kanäle im Audiodatenstrom abzurufen, die von Spitzenzählern überwacht werden.

Anforderungen

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

IAudioMeterInformation::GetMeteringChannelCount