KSPROPERTY_AUDIOEFFECTSDISCOVERY_EFFECTSLIST
Properti KSPROPERTY_AUDIOEFFECTSDISCOVERY_EFFECTSLIST adalah properti filter yang nilainya adalah daftar jenis efek audio yang diterapkan ke pabrik pin KS tertentu, untuk jalur pemrosesan sinyal audio tertentu.
Tabel Ringkasan Penggunaan
Tabel Ringkasan Penggunaan
| Dapatkan | Set | Target | Jenis deskriptor properti | Jenis nilai properti |
|---|---|---|---|---|
Ya |
Tidak |
Menyematkan pabrik (melalui instans Filter) |
KSP_PIN |
KSP_PINMODE |
Nilai properti adalah array guid jenis efek audio nol atau lebih (misalnya, AUDIO_EFFECT_TYPE_ACOUSTIC_ECHO_CANCELLATION) yang berada di jalur pemrosesan sinyal pin yang diidentifikasi oleh struktur KSP_PINMODE .
Catatan Bit bendera KSPROPERTY_TYPE_TOPOLOGY tidak boleh diatur untuk properti ini.
Tampilkan Nilai
Permintaan properti KSPROPERTY_AUDIOEFFECTSDISCOVERY_EFFECTSLIST mengembalikan STATUS_SUCCESS untuk menunjukkan bahwa permintaan telah berhasil diselesaikan. Jika tidak, permintaan properti ini mengembalikan kode status kesalahan yang sesuai.
Keterangan
Jika driver audio menggunakan APO proksi generik Microsoft untuk mengambil efek audio yang disertakan dalam jalur pemrosesan sinyal yang berbeda untuk pin KS, maka harus mendukung properti ini. APO proksi generik terkandung dalam file msapofxproxy.dll . Driver audio dapat menggunakan APO proksi generik ini ketika semua pemrosesan sinyal dilakukan di driver audio, atau di komponen perangkat keras prosesor sinyal digital (DSP) yang sesuai, tanpa pemrosesan dilakukan dalam APO. Dalam hal ini, satu-satunya fungsi APO adalah melaporkan efek pemrosesan sinyal ke sistem audio.
APO proksi generik menerima KSPROPERTY_AUDIOEFFECTSDISCOVERY_EFFECTSLIST dari driver audio dan menggunakannya untuk melaporkan efek ke sistem audio. APO proksi generik mengasumsikan bahwa daftar efek tidak berubah saat antarmuka filter pin KS diaktifkan.
Jika deskriptor properti menentukan pin KS yang tidak mendukung KSPROPERTY_AUDIOEFFECTSDISCOVERY_EFFECTSLIST, maka driver harus mengembalikan STATUS_NOT_SUPPORTED.
Jika deskriptor properti menentukan nilai AudioProcessingMode yang tidak didukung driver, maka driver harus mengembalikan STATUS_INVALID_PARAMETER. Perhatikan bahwa driver audio harus mendukung properti KSPROPERTY_AUDIOSIGNALPROCESSING_MODES agar dapat menunjukkan mode pemrosesan sinyal audio yang didukung.
Persyaratan
Versi |
Windows 8.1 |
Header |
Msapofxproxy.h |