KSPROPERTY_AUDIO_MIC_ARRAY_GEOMETRY
Properti KSPROPERTY_AUDIO_MIC_ARRAY_GEOMETRY menentukan geometri array mikrofon.
Tabel Ringkasan Penggunaan
Tabel Ringkasan Penggunaan
Dapatkan |
Set |
Target |
Tipe deskriptor properti |
Tipe nilai properti |
Ya |
Tidak |
Filter |
KSP_PIN | KSAUDIO_MIC_ARRAY_GEOMETRY |
Nilai properti (data operasi) adalah tipe KSAUDIO_MIC_ARRAY_GEOMETRY. Lihat definisi struktur KSAUDIO_MIC_ARRAY_GEOMETRY untuk detailnya.
Nilai Pengembalian
Permintaan properti KSPROPERTY_AUDIO_MIC_ARRAY_GEOMETRY mengembalikan STATUS_SUCCESS setelah berhasil menyelesaikan permintaan.
Jika pin yang ditunjukkan oleh anggota PinId dari struktur KSP_PIN tidak mendukung permintaan array mikrofon, permintaan properti akan kembali STATUS_NOT_SUPPORTED.
Jika ukuran buffer permintaan diatur ke nol, permintaan properti akan mengembalikan status STATUS_BUFFER_OVERFLOW. Selain itu, permintaan akan menggunakan blok status kembali untuk menunjukkan ukuran struktur KSAUDIO_MIC_ARRAY_GEOMETRY yang didukung oleh pin.
Jika ukuran buffer permintaan diatur ke ukuran buffer yang terlalu kecil untuk mengakomodasi struktur yang dikembalikan, permintaan mengembalikan status STATUS_BUFFER_TOO_SMALL. Permintaan kemudian akan menggunakan blok status kembali untuk menunjukkan ukuran struktur KSAUDIO_MIC_ARRAY_GEOMETRY yang didukung oleh pin.
Keterangan
Properti KSPROPERTY_AUDIO_MIC_ARRAY_GEOMETRY hanya mendukung permintaan KSPROPERTY_TYPE_GET. Agar klien dapat menentukan ukuran buffer yang benar yang diperlukan untuk mengakomodasi seluruh struktur geometri, pertama-tama klien harus membuat permintaan dengan ukuran buffer nol. Klien kemudian dapat menggunakan nilai yang dikembalikan dalam blok status untuk mengatur ukuran buffer dengan benar dan kemudian membuat permintaan properti lain dengan buffer berukuran benar.
Untuk informasi selengkapnya tentang cara memproses array mikrofon di Windows, lihat sumber daya berikut:
Properti Geometri Array Mikrofon
Dukungan Array Mikrofon dalam Windows (kertas putih)
Persyaratan
Header |
Ksmedia.h (termasuk Ksmedia.h) |