Antarmuka Audio Inti
Referensi pemrograman untuk Core Audio SDK ini mencakup antarmuka berikut:
MMDevice API
WINDOWS Multimedia Device (MMDevice) API memungkinkan klien audio untuk menemukan perangkat titik akhir audio, menentukan kemampuannya, dan membuat instans driver untuk perangkat tersebut. File header Mmdeviceapi.h mendefinisikan antarmuka dalam MMDevice API. Untuk informasi selengkapnya, lihat Tentang MMDevice API.
Tabel berikut mencantumkan antarmuka MMDevice yang tersedia dengan Core Audio SDK untuk Windows Vista.
| Antarmuka | Deskripsi |
|---|---|
| IMMDevice | Mewakili perangkat audio. |
| IMMDeviceCollection | Mewakili kumpulan perangkat audio. |
| IMMDeviceEnumerator | Menyediakan metode untuk menghitung perangkat audio. |
| IMMEndpoint | Mewakili perangkat titik akhir audio. |
| IMMNotificationClient | Menyediakan pemberitahuan saat perangkat titik akhir audio ditambahkan atau dihapus, saat status atau properti perangkat berubah, atau ketika ada perubahan dalam peran default yang ditetapkan ke perangkat. |
WASAPI
WINDOWS Audio Session API (WASAPI) memungkinkan aplikasi klien mengelola aliran data audio antara aplikasi dan perangkat titik akhir audio. File header Audioclient.h dan Audiopolicy.h menentukan antarmuka WASAPI. Untuk informasi selengkapnya, lihat Tentang WASAPI.
Tabel berikut mencantumkan antarmuka WASAPI yang tersedia dengan Core Audio SDK untuk Windows Vista dan yang lebih baru.
| Antarmuka | Deskripsi |
|---|---|
| IActivateAudioInterfaceAsyncOperation | Mewakili operasi asinkron yang mengaktifkan antarmuka WASAPI dan menyediakan metode untuk mengambil hasil aktivasi. Berlaku dimulai dengan Windows 8. |
| IActivateAudioInterfaceCompletionHandler | Menyediakan panggilan balik untuk menunjukkan bahwa aktivasi antarmuka WASAPI selesai. Berlaku dimulai dengan Windows 8. |
| IAudioCaptureClient | Memungkinkan klien membaca data input dari buffer titik akhir pengambilan. |
| IAudioClient | Memungkinkan klien membuat dan menginisialisasi aliran audio antara aplikasi audio dan mesin audio atau buffer perangkat keras perangkat titik akhir audio. |
| IAudioClock | Memungkinkan klien untuk memantau laju data aliran dan posisi saat ini di aliran. |
| IAudioClock2 |
Memungkinkan klien untuk mendapatkan posisi perangkat saat ini. |
| IAudioClockAdjustment |
Memungkinkan klien untuk mengatur laju sampel aliran. |
| IAudioRenderClient | Memungkinkan klien menulis data output ke buffer titik akhir penyajian. |
| IAudioSessionControl | Memungkinkan klien mengonfigurasi parameter kontrol untuk sesi audio dan memantau peristiwa dalam sesi. |
| IAudioSessionControl2 |
Memungkinkan klien untuk mendapatkan informasi tentang sesi audio. |
| IAudioSessionManager | Memungkinkan klien mengakses kontrol sesi dan kontrol volume untuk sesi audio lintas proses dan khusus proses. |
| IAudioSessionManager2 |
Mengelola semua submix termasuk enumerasi dan pemberitahuan submix. Ini juga menyediakan dukungan untuk pemberitahuan bebek. |
| IAudioSessionEnumerator |
Memungkinkan klien menghitung sesi audio. |
| IAudioStreamVolume | Memungkinkan klien mengontrol dan memantau tingkat volume untuk semua saluran dalam aliran audio. |
| IChannelAudioVolume | Memungkinkan klien mengontrol tingkat volume untuk semua saluran dalam sesi audio tempat aliran berada. |
| ISimpleAudioVolume | Memungkinkan klien mengontrol tingkat volume master sesi audio. |
| IAudioSessionEvents | Menyediakan pemberitahuan peristiwa terkait sesi seperti perubahan tingkat volume, nama tampilan, dan status sesi. |
| IAudioSessionNotification |
Mengirim pemberitahuan ketika perubahan sesi terjadi. |
| IAudioVolumeDuckNotification |
Mengirim pemberitahuan tentang perubahan bebek sistem yang tertunda. |
DeviceTopology API
API DeviceTopology menyediakan aplikasi klien dengan kemampuan untuk melintasi topologi perangkat keras fungsional dari perangkat penyajian dan penangkapan audio. File header Devicetopology.h mendefinisikan antarmuka dalam API DeviceTopology. Untuk informasi selengkapnya, lihat Topologi Perangkat dan API DeviceTopology.
Tabel berikut mencantumkan antarmuka DeviceTopology yang tersedia dengan Core Audio SDK untuk Windows Vista dan yang lebih baru.
| Antarmuka | Deskripsi |
|---|---|
| IAudioAutoGainControl | Menyediakan akses ke kontrol perolehan otomatis (AGC) perangkat keras. |
| IAudioBass | Menyediakan akses ke kontrol tingkat bass perangkat keras. |
| IAudioChannelConfig | Menyediakan akses ke kontrol konfigurasi saluran perangkat keras. |
| IAudioInputSelector | Menyediakan akses ke kontrol multiplexer perangkat keras (pemilih input). |
| IAudioLoudness | Menyediakan akses ke kontrol kompensasi "kenyaringan". |
| IAudioMidrange | Menyediakan akses ke kontrol tingkat midrange perangkat keras. |
| IAudioMute | Menyediakan akses ke kontrol bisu perangkat keras. |
| IAudioOutputSelector | Menyediakan akses ke kontrol demultiplexer perangkat keras (pemilih output). |
| IAudioPeakMeter | Menyediakan akses ke kontrol pengukur puncak perangkat keras. |
| IAudioTreble | Menyediakan akses ke kontrol tingkat treble perangkat keras. |
| IAudioVolumeLevel | Menyediakan akses ke kontrol volume perangkat keras. |
| Aku Koneksi or | Mewakili titik koneksi antar komponen. |
| IControlInterface | Mewakili antarmuka kontrol pada bagian (subunit atau konektor). |
| IDeviceSpecificProperty | Mewakili properti khusus perangkat dari konektor atau subunit. |
| IDeviceTopology | Menyediakan akses ke topologi perangkat audio. |
| IKsFormatSupport | Menyediakan informasi tentang format data audio yang didukung oleh koneksi I/O yang dikonfigurasi perangkat lunak (biasanya saluran DMA) antara perangkat audio dan memori sistem. |
| IKsJackDescription | Menyediakan informasi tentang jack atau konektor internal yang menyediakan koneksi fisik antara perangkat pada adaptor audio dan perangkat titik akhir eksternal atau internal (misalnya, mikrofon atau pemutar CD). |
| IKsJackDescription2 |
Menyediakan akses mudah ke properti KSPROPERTY_JACK_DESCRIPTION2 konektor ke perangkat titik akhir. |
| IKsJackSinkInformation |
Menyediakan informasi tentang sink jack jika jack didukung oleh perangkat keras. |
| IPart | Mewakili bagian (konektor atau subunit) dari topologi perangkat. |
| IPartsList | Mewakili daftar bagian (konektor dan subunit). |
| IPerChannelDbLevel | Mewakili antarmuka kontrol subunit generik yang menyediakan kontrol per saluran atas tingkat volume, dalam desibel, aliran audio atau pita frekuensi dalam aliran audio. |
| ISubunit | Mewakili subunit perangkat keras (misalnya, kontrol tingkat volume) yang terletak di jalur data antara klien dan perangkat titik akhir audio. |
| IControlChangeNotify | Menyediakan pemberitahuan saat status bagian (konektor atau subunit) berubah. |
EndpointVolume API
Api EndpointVolume memungkinkan klien khusus untuk mengontrol dan memantau tingkat volume perangkat titik akhir audio. File header Endpointvolume.h mendefinisikan antarmuka di Api EndpointVolume. Untuk informasi selengkapnya, lihat Api EndpointVolume .
Tabel berikut mencantumkan antarmuka EndpointVolume yang tersedia dengan Core Audio SDK untuk Windows Vista.
| Interface | Keterangan |
|---|---|
| IAudioEndpointVolume | Mewakili kontrol volume pada aliran audio ke atau dari perangkat titik akhir audio. |
| IAudioEndpointVolumeEx |
Menyediakan kontrol volume pada aliran audio ke atau dari titik akhir perangkat. |
| IAudioMeterInformation | Mewakili pengukur puncak pada aliran audio ke atau dari perangkat titik akhir audio. |
| IAudioEndpointVolumeCallback | Menyediakan pemberitahuan saat tingkat volume atau status matikan suara perangkat titik akhir audio berubah. |