Metode IAudioMeterInformation::GetPeakValue (endpointvolume.h)

Metode GetPeakValue mendapatkan nilai sampel puncak untuk saluran di aliran audio.

Sintaks

HRESULT GetPeakValue(
  [out] float *pfPeak
);

Parameter

[out] pfPeak

Penunjuk ke variabel float tempat metode menulis nilai sampel puncak untuk aliran audio. Nilai puncak adalah angka dalam rentang yang dinormalisasi dari 0,0 hingga 1,0.

Mengembalikan nilai

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

Menampilkan kode	Deskripsi
E_POINTER	Parameter pfPeak adalah NULL.

Keterangan

Metode ini mengambil nilai sampel puncak yang dicatat di semua saluran dalam 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 dicatat selama periode perangkat sebelumnya. Untuk mendapatkan periode perangkat, panggil metode IAudioClient::GetDevicePeriod .

Untuk contoh kode yang menggunakan metode GetPeakValue , lihat Meter Puncak.

Persyaratan

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