Antarmuka IAudioVolumeLevel (devicetopology.h)

Antarmuka IAudioVolumeLevel menyediakan akses ke kontrol volume perangkat keras. Klien mendapatkan referensi ke antarmuka IAudioVolumeLevel subunit dengan memanggil metode IPart::Activate dengan parameter refiid diatur ke REFIID IID_IAudioVolumeLevel. Panggilan ke IPart::Activate hanya berhasil jika subunit mendukung antarmuka IAudioVolumeLevel . Hanya objek subunit yang mewakili kontrol tingkat volume perangkat keras yang akan mendukung antarmuka ini.

Antarmuka IAudioVolumeLevel menyediakan kontrol per saluran untuk pengaturan dan mendapatkan tingkat perolehan atau redaman di aliran audio. Jika kontrol perangkat keras tingkat volume hanya dapat meredakan saluran dalam aliran audio, maka tingkat volume maksimum untuk saluran apa pun adalah 0 dB. Jika kontrol tingkat volume dapat memberikan keuntungan (amplifikasi), maka tingkat volume maksimum lebih besar dari 0 dB.

Sebagian besar driver adaptor audio Windows mendukung Windows Driver Model (WDM) dan menggunakan properti kernel-streaming (KS) untuk mewakili parameter kontrol perangkat keras dalam subunit (disebut sebagai simpul KS). Antarmuka IAudioVolumeLevel menyediakan akses mudah ke properti KSPROPERTY_AUDIO_VOLUMELEVEL subunit yang memiliki nilai GUID subjenis KSNODETYPE_VOLUME. Untuk mendapatkan GUID subjenis sub-subunit, panggil metode IPart::GetSubType . Untuk informasi selengkapnya tentang properti KS dan jenis node KS, lihat dokumentasi Windows DDK.

Warisan

Antarmuka IAudioVolumeLevel mewarisi dari antarmuka IPerChannelDbLevel.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2008 [hanya aplikasi desktop]
Target Platform	Windows
Header	devicetopology.h

Lihat juga

Antarmuka Audio Inti

DeviceTopology API

IPart::Activate

Antarmuka IPerChannelDbLevel