Antarmuka untuk Aplikasi
Bagian ini menjelaskan antarmuka yang digunakan atau diimplementasikan oleh aplikasi menggunakan Windows Media Device Manager SDK untuk berkomunikasi dengan perangkat. Istilah "aplikasi" yang digunakan di sini berarti objek yang dapat dieksekusi, plug-in, atau COM yang ada di komputer desktop dan membutuhkan komunikasi tingkat tinggi dengan perangkat portabel yang terhubung. Ini dapat mencakup aplikasi pemutar media, plug-in Pemutar Media Windows (jika memerlukan akses langsung ke perangkat portabel), atau objek COM pengukuran jumlah putar.
Beberapa antarmuka ini diimplementasikan oleh aplikasi, sementara yang lain dipanggil oleh aplikasi. Dokumentasi untuk setiap antarmuka menunjukkan apakah itu diimplementasikan atau dipanggil (dan jika diimplementasikan, baik opsional atau diperlukan).
Antarmuka atau kelas berikut digunakan oleh aplikasi.
| Antarmuka atau kelas | Deskripsi |
|---|---|
| Kelas CSecureChannelClient | Kelas pembantu yang memungkinkan aplikasi untuk mengautentikasi diri mereka sendiri, mengenkripsi dan mendekripsi data, dan membuat MAC. |
| IWMDeviceManager | Antarmuka Windows Media Device Manager tingkat atas untuk aplikasi. |
| IWMDeviceManager2 | Memperluas IWMDeviceManager dengan menyediakan metode enumerasi tingkat lanjut dan metode lainnya. |
| IWMDeviceManager3 | Memperluas antarmuka IWMDeviceManager2 dengan menyediakan metode yang mengatur preferensi enumerasi perangkat. |
| IWMDMDevice | Menyediakan metode untuk memeriksa dan menjelajahi satu perangkat portabel. |
| IWMDMDevice2 | Memperluas IWMDMDevice dengan memungkinkan untuk mendapatkan format video yang didukung oleh perangkat, menemukan penyimpanan berdasarkan nama, dan menggunakan halaman properti. |
| IWMDMDevice3 | Memperluas IWMDMDevice2 dengan menyediakan metode untuk mengkueri perangkat untuk properti, mengirim kode kontrol I/O perangkat, dan juga menyediakan metode yang ditingkatkan untuk mencari penyimpanan dan mengambil kemampuan format perangkat. |
| IWMDMDeviceControl | Menyediakan metode untuk mengontrol perangkat. |
| IWMDMDeviceSession | Meningkatkan efisiensi operasi perangkat dengan menggabungkan beberapa operasi ke dalam satu sesi |
| IWMDMEnumDevice | Menghitung perangkat portabel yang terpasang pada komputer. |
| IWMDMEnumStorage | Menghitung penyimpanan pada perangkat. |
| IWMDMMetaData | Mengatur dan mengambil properti metadata (seperti artis, album, genre, dan sebagainya) penyimpanan. |
| IWMDMObjectInfo | Mendapatkan dan mengatur informasi yang mengontrol bagaimana file yang dapat dimainkan pada perangkat ditangani oleh antarmuka IWMDMDeviceControl |
| IWMDMRevoked | Mengambil URL tempat komponen yang diperbarui dapat diunduh, jika transfer gagal dengan kesalahan pencabutan. |
| IWMDMStorage | Menyediakan metode untuk memeriksa dan menjelajahi penyimpanan (file, folder, daftar putar) pada perangkat. |
| IWMDMStorage2 | Memperluas IWMDMStorage dengan memungkinkan untuk mendapatkan penyimpanan anak berdasarkan nama, dan untuk mendapatkan dan mengatur atribut yang diperluas. |
| IWMDMStorage3 | Memperluas IWMDMStorage2 dengan mengekspos metadata. |
| IWMDMStorage4 | Memperluas IWMDMStorage3 dengan menyediakan metode untuk mengambil subset metadata yang tersedia untuk penyimpanan, dan untuk mengatur dan mengambil daftar referensi ke penyimpanan lain. |
| IWMDMStorageControl | Digunakan untuk menyisipkan, menghapus, atau memindahkan file dalam perangkat, atau antara perangkat dan komputer. |
| IWMDMStorageControl2 | Memperluas IWMDMStorageControl dengan memungkinkan untuk mengatur nama file tujuan saat menyisipkan konten ke dalam penyimpanan. |
| IWMDMStorageControl3 | Memperluas IWMDMStorageControl2 dengan memungkinkan untuk meneruskan penunjuk antarmuka IWMDMMetaData . |
| IWMDMStorageGlobals | Menyediakan metode untuk mengambil informasi global tentang media penyimpanan (seperti kartu flash ROM) pada perangkat. |
| IWMDRMDeviceApp | Memungkinkan aplikasi untuk melakukan pengukuran, sinkronisasi lisensi, dan pembaruan komponen DRM perangkat. |
| IWMDRMDeviceApp2 | Memperluas IWMDRMDeviceApp dengan menyediakan versi baru metode QueryDeviceStatus . |
Antarmuka Panggilan Balik
Antarmuka opsional berikut diimplementasikan oleh aplikasi untuk melacak kemajuan permintaan asinkron, seperti permintaan baca atau tulis.
| Antarmuka | Deskripsi |
|---|---|
| IWMDMNotification | Memungkinkan aplikasi dan penyedia layanan menerima pemberitahuan ketika perangkat atau penyimpanan memori (seperti kartu RAM) terhubung atau terputus dari komputer. |
| IWMDMOperation2 | Memperluas IWMDMOperation dengan menyediakan metode untuk mendapatkan dan mengatur atribut yang diperluas. |
| IWMDMOperation3 | Memperluas IWMDMOperation dengan menyediakan metode baru untuk mentransfer data yang tidak terenkripsi untuk efisiensi tambahan. |
| IWMDMOperation | Memungkinkan aplikasi mengontrol bagaimana data dibaca dari atau ditulis ke komputer selama transfer file. |
| IWMDMProgress2 | Memperluas metode IWMDMProgress::End dengan memberikan indikator status. |
| IWMDMProgress3 | Memperluas IWMDMProgress2 dengan menyediakan parameter input tambahan untuk menentukan ID peristiwa dan informasi khusus konteks. |
| IWMDMProgress | Memungkinkan aplikasi melacak kemajuan operasi, seperti memformat media atau transfer file. |
Diagram berikut menunjukkan bagaimana sebagian besar antarmuka aplikasi penting diperoleh dari antarmuka IWMDeviceManager akar. Aplikasi mendapatkan antarmuka akar ini dengan membuat bersama objek MediaDevMgr, meminta antarmuka IComponentAuthenticate, mengautentikasi komponen, lalu meminta IWMDeviceManager (langkah-langkah ini dijelaskan dalam Mengautentikasi Aplikasi). Setelah antarmuka akar ini diperoleh, IWMDeviceManager::EnumDevices dipanggil untuk membuat objek yang mengimplementasikan IWMDMEnumDevice. Antarmuka lain diperoleh dengan memanggil metode pada antarmuka dalam urutan yang ditampilkan. Antarmuka turunan seperti IWMDMDevice2 diperoleh dengan memanggil QueryInterface pada antarmuka dasar.
Dalam diagram berikut, antarmuka turunan diberi label dengan tanda garis miring, sehingga "IWMDMStorage/2/3" akan menunjukkan IWMDMStorage, IWMDMStorage2, dan IWMDMStorage3.
Topik terkait