Metode IAudioMeterInformation::GetChannelsPeakValues (endpointvolume.h)

  • Artikel

Metode GetChannelsPeakValues mendapatkan nilai sampel puncak untuk semua saluran di aliran audio.

Sintaks

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

Parameter

[in] u32ChannelCount

Jumlah saluran. Parameter ini juga menentukan jumlah elemen dalam array afPeakValues . Jika jumlah yang ditentukan tidak cocok dengan jumlah saluran dalam aliran, metode mengembalikan kode kesalahan E_INVALIDARG.

[out] afPeakValues

Penunjuk ke array nilai sampel puncak. Metode ini menulis nilai puncak untuk saluran ke dalam array. Array berisi satu elemen untuk setiap saluran dalam aliran. Nilai puncak adalah angka dalam rentang yang dinormalisasi dari 0,0 hingga 1,0.

Nilai kembali

Jika metode berhasil, metode akan mengembalikan S_OK. Jika gagal, kemungkinan kode pengembalian disertakan, tetapi tidak terbatas pada, nilai yang diperlihatkan dalam tabel berikut.

Menampilkan kode Deskripsi
E_INVALIDARG
 Parameter u32ChannelCount tidak sama dengan jumlah saluran dalam aliran audio.
E_POINTER
 Parameter afPeakValues adalah NULL.

Keterangan

Metode ini mengambil nilai sampel puncak untuk saluran di aliran. Nilai puncak untuk setiap saluran direkam selama satu periode perangkat dan tersedia selama periode perangkat berikutnya. Dengan demikian, metode ini selalu mengambil nilai puncak yang direkam selama periode perangkat sebelumnya. Untuk mendapatkan periode perangkat, panggil metode IAudioClient::GetDevicePeriod .

Parameter afPeakValues menunjuk ke array float yang dialokasikan penelepon. Jika aliran berisi saluran n , saluran diberi nomor 0 hingga n– 1. Metode ini menyimpan nilai puncak untuk setiap saluran dalam elemen array yang indeks arraynya cocok dengan nomor saluran. Untuk mendapatkan jumlah saluran dalam aliran audio yang dipantau oleh meter puncak, panggil metode IAudioMeterInformation::GetMeteringChannelCount .

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows Vista [aplikasi desktop | Aplikasi UWP]
Server minimum yang didukung Windows Server 2008 [aplikasi desktop | Aplikasi UWP]
Target Platform Windows
Header endpointvolume.h

Lihat juga

IAudioClient::GetDevicePeriod

Antarmuka IAudioMeterInformation

IAudioMeterInformation::GetMeteringChannelCount