Metode IAudioEndpointVolume::GetVolumeStepInfo (endpointvolume.h)

Metode GetVolumeStepInfo mendapatkan informasi tentang langkah saat ini dalam rentang volume.

Sintaks

HRESULT GetVolumeStepInfo(
  [out] UINT *pnStep,
  [out] UINT *pnStepCount
);

Parameter

[out] pnStep

Arahkan ke variabel UINT tempat metode menulis indeks langkah saat ini. Indeks ini adalah nilai dalam rentang dari 0 hingga *pStepCount– 1, di mana 0 mewakili tingkat volume minimum dan *pStepCount– 1 mewakili tingkat maksimum.

[out] pnStepCount

Penunjuk ke variabel UINT tempat metode menulis jumlah langkah dalam rentang volume. Angka ini tetap konstan selama masa pakai instans antarmuka IAudioEndpointVolume .

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_POINTER	Parameter pnStep dan pnStepCount keduanya NULL.

Keterangan

Metode ini mewakili tingkat volume aliran audio yang memasuki atau meninggalkan perangkat titik akhir audio sebagai indeks atau "langkah" dalam berbagai tingkat volume diskrit. Nilai output *pnStepCount adalah jumlah langkah dalam rentang. Nilai output *pnStep adalah indeks langkah dari tingkat volume saat ini. Jika jumlah langkah adalah n = *pnStepCount, maka indeks langkah *pnStep dapat mengasumsikan nilai dari 0 (volume minimum) hingga n – 1 (volume maksimum).

Selama rentang dari 0 hingga n – 1, interval berturut-turut antara langkah-langkah yang berdekatan tidak selalu mewakili kenaikan volume seragam baik dalam amplitudo sinyal linier atau desibel. Di Windows Vista, GetVolumeStepInfo mendefinisikan hubungan indeks 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 Kontrol Volume Audio-Tapered.

Aplikasi audio dapat memanggil metode IAudioEndpointVolume::VolumeStepUp dan IAudioEndpointVolume::VolumeStepDown untuk meningkatkan atau mengurangi tingkat volume satu interval. Salah satu metode pertama-tama menghitung tingkat volume ideal yang sesuai dengan titik berikutnya pada kurva audio-tapered. Selanjutnya, metode memilih pengaturan volume titik akhir yang merupakan perkiraan terbaik ke tingkat ideal. Untuk mendapatkan rentang dan granularitas pengaturan volume titik akhir, panggil metode IEndpointVolume::GetVolumeRange . Jika perangkat titik akhir audio menerapkan kontrol volume perangkat keras, GetVolumeRange menjelaskan pengaturan volume perangkat keras. Jika tidak, Api EndpointVolume mengimplementasikan kontrol volume titik akhir dalam perangkat lunak, dan GetVolumeRange menjelaskan pengaturan volume kontrol yang diterapkan perangkat lunak.

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::VolumeStepDown

IAudioEndpointVolume::VolumeStepUp