Objek (Windows Media Format 11 SDK)
SDK Format Media Windows menggunakan beberapa objek untuk membaca, menulis, mengedit, dan mengindeks file ASF, dan untuk membuat dan mengedit profil. Setiap objek mendukung sejumlah antarmuka. Beberapa antarmuka didukung di beberapa objek. Dalam kasus ini, setiap perbedaan dalam implementasi dibahas di bagian referensi untuk antarmuka.
Objek dalam SDK Format Media Windows mematuhi COM. Untuk mempermudah pengembangan, setiap objek memiliki fungsi atau metode pembuatan terkait. Anda harus membuat objek dengan menggunakan fungsi atau metode pembuatan daripada secara manual menggunakan fungsi COM CoCreateInstance.
Beberapa antarmuka memiliki angka yang ditambahkan ke namanya, seperti IWMProfile2 dan IWMWriter3. Dalam setiap kasus, versi bernomor mewarisi semua metode versi sebelumnya dan menambahkan fungsionalitas baru.
Pada setiap halaman objek referensi ini, antarmuka yang disertakan dalam objek COM utama dicantumkan terlebih dahulu, diikuti oleh antarmuka panggilan balik yang harus diimplementasikan oleh aplikasi.
Tabel berikut mencantumkan objek yang didukung oleh SDK ini dengan deskripsi fungsionalitas masing-masing dan fungsi yang digunakan untuk membuatnya.
| Objek | Deskripsi | Fungsi pembuatan |
|---|---|---|
| Pemulihan Cadangan | Mencadangkan lisensi, biasanya ke media yang dapat dilepas, lalu memulihkan lisensi tersebut ke komputer lain. | WMCreateBackupRestorer |
| Pendaftaran Perangkat | Mengelola database pendaftaran perangkat, yang berisi entri untuk perangkat pemutaran media yang tersedia melalui koneksi jaringan. | WMCreateDeviceRegistration |
| DRM Transcryptor | Mengonversi data media yang dilindungi DRM menjadi aliran data yang dapat dikirim ke perangkat yang menggunakan Windows Media DRM 10 untuk protokol Perangkat Jaringan. | WMCreateDRMTranscryptor |
| Pengindeks | Membuat indeks untuk file ASF untuk mengaktifkan pencarian dalam file dengan aliran video. | WMCreateIndexer |
| Agen Pencabutan Lisensi | Mengelola pencabutan lisensi. | WMCreateLicenseRevocationAgent |
| Metadata Editor | Mengedit metadata dalam header file ASF. | WMCreateEditor |
| Manajer Profil | Menyediakan antarmuka untuk membuat, memuat, dan menyimpan profil. Profil diperlukan untuk menulis file ASF. | WMCreateProfileManager |
| Pembaca | Membaca file ASF. Objek ini menggunakan model panggilan asinkron untuk operasinya. | WMCreateReader |
| Pembaca Sinkron | Membaca file ASF menggunakan panggilan sinkron. | WMCreateSyncReader |
| Penulis | Menulis file ASF. | WMCreateWriter |
| Writer File Sink | Mengontrol file ASF yang ditulis oleh objek penulis. | WMCreateWriterFileSink |
| Writer Network Sink | Mengontrol streaming jaringan langsung file ASF yang ditulis oleh objek penulis. | WMCreateWriterNetworkSink |
| Writer Push Sink | Mengontrol pengiriman konten streaming ke server penerbitan. | WMCreateWriterPushSink |
Tabel berikut ini mencantumkan objek yang bergantung pada objek lain. Objek ini dibuat oleh metode objek yang ada.
| Objek | Deskripsi | Metode Pembuatan |
|---|---|---|
| Berbagi Bandwidth | Mengelola informasi berbagi bandwidth di profil. Lebih dari satu objek berbagi bandwidth mungkin ada untuk profil. Ada metode yang berbeda untuk membuat objek berbagi bandwidth tergantung pada apakah Anda ingin membuat objek berbagi bandwidth baru atau mengakses yang sudah ada. | IWMProfile3::CreateNewBandwidthSharing ATAU IWMProfile3::GetBandwidthSharing |
| Buffer | Berisi sampel media dan ekstensi unit data terkait. Digunakan untuk menulis dan membaca sampel. | IWMWriter::AllocateSample ATAU IWMReaderAllocatorEx::AllocateForOutputEx ATAU IWMReaderAllocatorEx::AllocateForStreamEx ATAU Dibuat secara otomatis oleh objek pembaca atau objek pembaca sinkron untuk pengiriman sampel. |
| Properti Media Input | Mengelola properti input. Satu objek properti input dapat ada untuk setiap input. | IWMWriter::GetInputProps |
| Pengecualian Timbal Balik | Mengelola informasi pengecualian timbal balik dalam profil. Penggunaan umum untuk pengecualian timbal balik adalah beberapa konten laju bit dan soundtrack dalam beberapa bahasa. Ada berbagai metode untuk membuat objek pengecualian timbal balik tergantung pada apakah Anda ingin membuat objek pengecualian timbal balik baru atau mengakses objek yang sudah ada. | IWMProfile::CreateNewMutualExclusion ATAU IWMProfile::GetMutualExclusion |
| Properti Media Output | Mengelola properti output. Satu objek properti media output dapat ada untuk setiap output. Objek ini dapat dibuat oleh pembaca atau oleh pembaca sinkron | IWMReader::GetOutputProps ATAU IWMSyncReader::GetOutputProps |
| Profil | Berisi data dalam profil saat sedang dimanipulasi. Objek profil dibuat kapan saja profil perlu dimanipulasi. Ada metode yang berbeda untuk membuat objek profil tergantung pada apakah Anda ingin membuat profil baru atau mengakses yang sudah ada. | IWMProfileManager::CreateEmptyProfile ATAU IWMProfileManager::LoadProfileByData ATAU IWMProfileManager::LoadProfileByID ATAU IWMProfileManager::LoadSystemProfile |
| Konfigurasi Aliran | Mengelola properti aliran dalam profil. Objek konfigurasi aliran dibuat oleh objek stream kapan saja Anda perlu mengakses informasi tentang aliran. Ada berbagai metode untuk membuat objek konfigurasi aliran tergantung pada apakah Anda ingin membuat aliran atau akses baru dan yang sudah ada. | IWMProfile::CreateNewStream ATAU IWMProfile::GetStream ATAU IWMProfile::GetStreamByNumber |
| Prioritas Aliran | Mempertahankan daftar prioritas aliran untuk profil. Aliran akan dihilangkan untuk meningkatkan prioritas jika bandwidth yang tersedia dibatasi. Hanya ada satu objek prioritas aliran di profil. | IWMProfile3::CreateNewStreamPrioritization |