Bagikan melalui

KSNODETYPE_PEAKMETER

  • Artikel

Simpul KSNODETYPE_PEAKMETER mewakili peakmeter perangkat keras. Simpul puncak KS memiliki satu pin input dan satu pin output, dan kedua pin memiliki format data yang sama.

Peakmeter KS secara internal mencatat nilai maksimum sinyal audio sejak terakhir kali peakmeter direset ke nol. Peakmeter secara otomatis mengatur ulang dirinya ke nol setelah permintaan IOCTL_KS_PROPERTY untuk mendapatkan properti KSPROPERTY_AUDIO_PEAKMETER2 .

Peakmeter memerlukan dukungan perangkat keras. Peakmeter perangkat lunak tidak layak, dan ini karena driver adaptor tidak memiliki akses ke sinyal yang ada pada line-in, mikrofon, atau input lain yang dicampur dengan saluran pemutaran.

Microsoft merekomendasikan untuk membuat simpul puncak simpul akhir di mana aliran melewati dalam filter. Pada aliran render, adaptor audio biasanya menyambungkan simpul puncak setelah output master KSNODETYPE_MUTE simpul atau simpul KSNODETYPE_VOLUME . Pendekatan yang sama berlaku untuk aliran pengambilan atau aliran lain yang filternya menggabungkan simpul puncak.

Adaptor audio harus memberi nama simpul peakmeter KSAUDFNAME_PEAKMETER.

Simpul peakmeter harus menyediakan handler properti untuk bendera properti (lihat KSPROPERTY) yang muncul dalam tabel berikut.

Nama Bendera Makna

KSPROPERTY_TYPE_GET

Mengembalikan nilai saat ini dari peakmeter perangkat keras.

KSPROPERTY_TYPE_BASICSUPPORT

Untuk KSPROPERTY_AUDIO_PEAKMETER - Mengembalikan rentang data 0x8000 ke 0x7fff, yang merupakan rentang data audio digital 16-bit. 16 bit atas harus diatur ke nol, untuk memungkinkan sistem operasi menerima nilai positif. Perhatikan bahwa KSPROPERTY_AUDIO_PEAKMETER tidak digunakan lagi dan KSPROPERTY_AUDIO_PEAKMETER2 harus digunakan sebagai gantinya.

Untuk KSPROPERTY_AUDIO_PEAKMETER2 - Mengembalikan rentang data LONG_MIN ke LONG_MAX.

Handler properti harus memverifikasi parameter input dan informasi saluran kiri dan kanan.

Simpul peakmeter juga harus mendukung properti dalam tabel berikut.

Nama Properti Deskripsi

KSPROPERTY_AUDIO_PEAKMETER2

Mewakili kontrol peakmeter.

KSPROPERTY_AUDIO_CPU_RESOURCES

Menunjukkan apakah fungsionalitas simpul yang ditentukan menggunakan CPU host.