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

Referensi Pemrograman