Properti Titik Akhir Audio
File header Mmdeviceapi.h mendefinisikan beberapa properti perangkat titik akhir audio di Windows Vista dan yang lebih baru. Layanan audio Windows mengatur nilai properti ini. Klien dapat membaca properti ini, tetapi tidak boleh mengaturnya. Nilai properti disimpan sebagai struktur PROPVARIANT.
Cara yang direkomendasikan untuk membaca properti perangkat input audio adalah dengan menggunakan API di namespaceWindows.Devices.Enumeration. API ini didukung untuk aplikasi Windows Store dan aplikasi desktop. Untuk aplikasi desktop yang sudah ada yang membaca properti perangkat menggunakan antarmukaIMMDevice, lihat Properti Perangkat. IMMDevice tidak didukung untuk aplikasi Windows Store.
Untuk contoh kode yang memperlihatkan cara mengakses properti perangkat titik akhir audio, lihat topik berikut:
Untuk informasi tentang PROPVARIANT, lihat dokumentasi Windows SDK.
Properti berikut ini khusus untuk perangkat titik akhir audio.
| Harta benda | Deskripsi |
|---|---|
| PKEY_AudioEndpoint_Association | Mengaitkan kategori pin kernel-streaming (KS) dengan perangkat titik akhir audio. |
| PKEY_AudioEndpoint_ControlPanelPageProvider | Menentukan CLSID penyedia terdaftar ekstensi properti perangkat untuk perangkat titik akhir audio. |
| PKEY_AudioEndpoint_Disable_SysFx | Menunjukkan apakah efek sistem diaktifkan dalam aliran mode bersama yang mengalir ke atau dari perangkat titik akhir audio. |
| PKEY_AudioEndpoint_FormFactor | Menunjukkan atribut fisik perangkat titik akhir audio. |
| PKEY_AudioEndpoint_FullRangeSpeakers | Menentukan masker konfigurasi saluran untuk speaker rentang penuh yang tersambung ke perangkat titik akhir audio. |
| PKEY_AudioEndpoint_GUID | Menyediakan pengidentifikasi perangkat DirectSound yang sesuai dengan perangkat titik akhir audio. |
| PKEY_AudioEndpoint_PhysicalSpeakers | Menentukan konfigurasi speaker fisik untuk perangkat titik akhir audio. |
| PKEY_AudioEngine_DeviceFormat | Menentukan format perangkat, yang merupakan format yang digunakan mesin audio untuk aliran mode bersama yang mengalir ke atau dari perangkat titik akhir audio. |
| PKEY_AudioEngine_OEMFormat | Menentukan format default perangkat yang digunakan untuk merender atau menangkap aliran. Nilai diisi oleh OEM dalam file .inf. |
| PKEY_AudioEndpoint_Supports_EventDriven_Mode | Menunjukkan apakah titik akhir mendukung mode berbasis peristiwa. Nilai diisi oleh OEM dalam file .inf. |
| PKEY_AudioEndpoint_JackSubType | Berisi GUID kategori output untuk perangkat titik akhir audio. |
API audio inti mendukung properti tambahan yang tidak berlaku secara eksklusif untuk perangkat titik akhir audio. Untuk informasi selengkapnya tentang properti tambahan ini, lihat Properti Perangkat.