Bagikan melalui


String ID Titik Akhir

Di Windows Vista, sistem menghasilkan string ID titik akhir untuk mengidentifikasi perangkat titik akhir audio dalam sistem. String ID titik akhir adalah string karakter lebar yang dihentikan null. String ID titik akhir untuk perangkat titik akhir audio tertentu secara unik mengidentifikasi perangkat di antara semua perangkat titik akhir audio dalam sistem.

Jika sistem berisi dua atau beberapa perangkat adaptor audio yang identik, perangkat titik akhir audio yang sesuai akan memiliki nama yang mudah diingat, tetapi setiap perangkat titik akhir akan memiliki string ID titik akhir yang unik. Untuk informasi selengkapnya tentang mendapatkan nama perangkat titik akhir yang mudah diingat, lihat Properti Perangkat.

Setelah mendapatkan instans antarmuka IMMDevice untuk perangkat titik akhir audio, klien dapat memanggil metode IMMDevice::GetId untuk mendapatkan string ID titik akhir untuk perangkat. Klien dapat menggunakan string ID titik akhir untuk membuat instans perangkat titik akhir audio di lain waktu atau dalam proses yang berbeda dengan memanggil metode IMMDeviceEnumerator::GetDevice.

Klien dapat mengatur untuk menerima pemberitahuan saat status perangkat titik akhir audio berubah. Untuk menerima pemberitahuan, klien mengimplementasikan antarmuka IMMNotificationClient dan mendaftarkan antarmuka tersebut dengan MMDevice API. Saat status perangkat titik akhir berubah, API MMDevice memanggil metode yang sesuai di antarmuka EDataFlow klien. Salah satu parameter input ke metode adalah string ID titik akhir yang mengidentifikasi perangkat titik akhir yang statusnya telah berubah. Untuk informasi selengkapnya tentang EDataFlow, lihat Peristiwa Perangkat.

API audio warisan seperti DirectSound dan fungsi multimedia Windows memiliki antarmuka mereka sendiri untuk menghitung dan mengidentifikasi perangkat audio. Di Windows Vista, antarmuka ini telah diperluas untuk menyediakan string ID titik akhir yang mengidentifikasi perangkat titik akhir yang mendasar abstraksi perangkat yang disajikan oleh API.

Selama enumerasi perangkat DirectSound, DirectSound menyediakan string ID titik akhir untuk setiap perangkat yang dijumlahkannya. Untuk informasi selengkapnya, lihat Peristiwa Audio untuk Aplikasi Audio Warisan.

Untuk mendapatkan string ID titik akhir untuk perangkat bentuk gelombang warisan, gunakan fungsi waveOutMessage atau waveInMessage untuk mengirim pesan DRV_QUERYFUNCTIONINSTANCEID ke driver perangkat bentuk gelombang. Untuk contoh kode yang menunjukkan penggunaan pesan ini, lihat Peran Perangkat untuk Aplikasi Multimedia Windows Warisan.

Untuk informasi selengkapnya tentang menggunakan kemampuan API audio inti untuk meningkatkan aplikasi yang menggunakan API audio lama, lihat Interoperabilitas dengan API Audio Warisan.

Klien harus memperlakukan konten string ID titik akhir sebagai buram. Artinya, klien tidak boleh mencoba mengurai konten string untuk mendapatkan informasi tentang perangkat. Alasannya adalah bahwa format string tidak ditentukan dan mungkin berubah dari satu implementasi modul sistem MMDevice API ke modul berikutnya.

Masa pakai string ID titik akhir terkait dengan penginstalan perangkat. String ID titik akhir perangkat berubah jika pengguna meningkatkan driver perangkat, atau jika pengguna menghapus instalan perangkat, dan menginstalnya lagi. Namun, string ID titik akhir tetap tidak berubah di seluruh mulai ulang sistem, dan string ID titik akhir perangkat audio USB tetap tidak berubah jika pengguna mencopot perangkat dan mencolokkannya kembali.

Perangkat Titik Akhir Audio