KSPROPERTY_AUDIO_CHANNEL_CONFIG

Artikel
06/15/2023

Properti KSPROPERTY_AUDIO_CHANNEL_CONFIG menentukan penempatan spasial saluran aktual dalam aliran audio yang dihasilkan simpul.

Tabel Ringkasan Penggunaan

Dapatkan	Set	Target	Jenis deskriptor properti	Jenis nilai properti
Ya	Ya	Filter/Sematkan	KSNODEPROPERTY	KSAUDIO_CHANNEL_CONFIG

Nilai properti (data operasi) adalah struktur jenis KSAUDIO_CHANNEL_CONFIG. Struktur ini menentukan saluran yang terkandung dalam aliran output dan penugasan saluran tersebut ke speaker.

Nilai Yang Dikembalikan

Permintaan properti KSPROPERTY_AUDIO_CHANNEL_CONFIG mengembalikan STATUS_SUCCESS untuk menunjukkan bahwa permintaan telah berhasil diselesaikan. Jika tidak, permintaan mengembalikan kode status kesalahan yang sesuai.

Keterangan

Saat digunakan sebagai properti simpul DAC (KSNODETYPE_DAC) atau simpul 3D (KSNODETYPE_3D_EFFECTS), properti KSPROPERTY_AUDIO_CHANNEL_CONFIG menentukan konfigurasi speaker DirectSound. Untuk konfigurasi speaker stereo, properti ini digunakan bersama dengan properti KSPROPERTY_AUDIO_STEREO_SPEAKER_GEOMETRY , yang membedakan antara headphone dan beberapa konfigurasi speaker stereo. Untuk informasi selengkapnya tentang konfigurasi pembicara, lihat Pengaturan Speaker-Configuration DirectSound.

DirectSound juga menggunakan properti KSPROPERTY_AUDIO_CHANNEL_CONFIG untuk mengkueri simpul "pan" untuk konfigurasi salurannya. Simpul pan adalah simpul volume kedua (KSNODETYPE_VOLUME) pada pin mixer yang memenuhi persyaratan pemesanan simpul DirectSound. Implementasi DirectSound dari metode IDirectSoundBuffer::SetPan (dijelaskan dalam dokumentasi Microsoft Windows SDK) menggunakan properti KSPROPERTY_AUDIO_VOLUMELEVEL simpul pan untuk mengontrol panning.

DirectSound memperlakukan KSPROPERTY_AUDIO_CHANNEL_CONFIG sebagai properti filter pada simpul DAC, dan sebagai properti pin pada volume dan simpul 3D.

Klien juga menggunakan properti ini untuk memilih format aliran yang KSNODETYPE_PROLOGIC_DECODER output simpul.