Persyaratan untuk Pemutar Audio Portabel untuk Muncul di Windows Explorer
Ekstensi namespace shell pemutar audio portabel memberi pengguna Windows cara yang konsisten untuk mengelola perangkat audio yang dikelola oleh Windows Media Device Manager. Jika Anda menulis penyedia layanan dan komponen driver sesuai dengan panduan berikut, perangkat Anda akan muncul di namespace shell. Pengguna akan dapat berinteraksi dengan konten perangkat Anda secara konsisten di Windows Explorer untuk melakukan operasi dasar seperti menyalin, menghapus, dan mengganti nama.
Persyaratan shell berikut untuk penyedia layanan dan komponen driver dimaksudkan untuk melengkapi pedoman Umum Windows Media Device Manager.
Kapabilitas Perangkat
Penyedia layanan Windows Media Device Manager harus eksplisit dalam kemampuan yang didukung. Jika panggilan tidak didukung, kode kesalahan harus dikembalikan. Bidang yang sesuai harus diatur untuk keberadaan atau tidak adanya kemampuan saat kembali dari fungsi berikut:
Penyedia layanan harus mendukung kemampuan berikut agar kompatibel dengan shell:
- Salin ke perangkat (dengan dukungan untuk panggilan balik pembatalan dan kemajuan)
- Menghapus file dari perangkat (dengan dukungan untuk panggilan balik pembatalan dan kemajuan)
- Mengganti nama file pada perangkat
- Pelaporan ruang (total ruang, ruang kosong, ruang yang tidak dapat digunakan)
- Plug and Play (lihat Mengaktifkan PnP untuk Perangkat)
- Format (sebaiknya dengan dukungan untuk panggilan balik pembatalan dan kemajuan)
Jika metadata didukung, bidang berikut harus didukung untuk file individual. Jika tidak ada data yang tersedia, bidang harus diinisialisasi sebagai string kosong:
| Bidang | Konstanta (ditentukan dalam WMDM.idl) | Tag metadata |
|---|---|---|
| Judul Lagu | g_wszWMDMTitle | WMDM/Judul |
| Nomor Trek | g_wszWMDMTrack | WMDM/Track |
| Artis | g_wszWMDMAuthor | WMDM/Penulis |
| Album | g_wszWMDMAlbumTitle | WMDM/AlbumTitle |
| Tahun | g_wszWMDMYear | WMDM/Tahun |
| Genre | g_wszWMDMGenre | WMDM/Genre |
Konkurensi
Driver mode kernel untuk Windows Media Device Manager harus kuat dalam menangani akses bersamaan. Misalnya, pengguna dapat secara bersamaan mengakses perangkat melalui shell dan pemutar media atau hanya melalui beberapa jendela di shell. Sebagai bagian dari penanganan konkurensi, driver tidak boleh berasumsi, hanya karena penyedia layanan dimuat, bahwa perangkat sedang digunakan. Sebaliknya, mereka harus menerapkan mekanisme penguncian untuk menserialisasikan akses ke perangkat sesuai kebutuhan untuk operasi individu.
UI
Penyedia layanan untuk Windows Media Device Manager tidak boleh menampilkan antarmuka pengguna apa pun. Kesalahan apa pun harus dikembalikan dari panggilan metode sebagai kode kesalahan Windows Media Device Manager tertentu jika memungkinkan.
Mengaktifkan di Shell
Jika paket Anda memenuhi semua persyaratan shell, Anda dapat mengaktifkan perangkat anda untuk ditampilkan di shell dengan mengatur nilai ShowInShell ke 1 di bawah parameter perangkat. Untuk informasi selengkapnya, lihat Parameter Perangkat.
Topik terkait