Metode IAudioEndpointVolume::VolumeStepDown (endpointvolume.h)

Metode VolumeStepDown mengalami penurunan, dengan satu langkah, tingkat volume aliran audio yang masuk atau meninggalkan perangkat titik akhir audio.

Sintaks

HRESULT VolumeStepDown(
  [in] LPCGUID pguidEventContext
);

Parameter

[in] pguidEventContext

Nilai konteks untuk metode IAudioEndpointVolumeCallback::OnNotify . Parameter ini menunjuk ke GUID konteks peristiwa. Jika panggilan VolumeStepDown mengubah tingkat volume titik akhir, semua klien yang telah mendaftarkan antarmuka IAudioEndpointVolumeCallback dengan titik akhir tersebut akan menerima pemberitahuan. Dalam implementasi metode OnNotify , klien dapat memeriksa GUID konteks peristiwa untuk menemukan apakah itu atau klien lain adalah sumber peristiwa perubahan volume. Jika penelepon menyediakan pointer NULL untuk parameter ini, metode pemberitahuan klien menerima penunjuk konteks NULL .

Nilai kembali

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_OUTOFMEMORY	Kehabisan memori.

Keterangan

Untuk mendapatkan langkah volume saat ini dan jumlah total langkah dalam rentang volume, panggil metode IAudioEndpointVolume::GetVolumeStepInfo .

Jika tingkat volume sudah pada langkah terendah dalam rentang volume, panggilan ke VolumeStepDown tidak berpengaruh dan mengembalikan kode status S_OK.

Interval berturut-turut antara langkah-langkah yang berdekatan tidak selalu mewakili kenaikan volume yang seragam baik dalam amplitudo sinyal linier atau desibel. Di Windows Vista, VolumeStepDown mendefinisikan hubungan indeks langkah ke tingkat volume (amplitude sinyal) menjadi kurva audio-tapered. Perhatikan bahwa bentuk kurva mungkin berubah dalam versi Windows yang akan datang. Untuk informasi selengkapnya tentang kurva audio-tapered, lihat Audio-Tapered Volume Controls.

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

Antarmuka IAudioEndpointVolume

IAudioEndpointVolume::GetVolumeStepInfo

Antarmuka IAudioEndpointVolumeCallback

IAudioEndpointVolumeCallback::OnNotify