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 |
---|---|
|
Der Parameter u32ChannelCount entspricht nicht der Anzahl der Kanäle im Audiodatenstrom. |
|
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 |