Antarmuka IWMProfile

[Fitur yang terkait dengan halaman ini, Windows Media Format 11 SDK, adalah fitur warisan. Ini telah digantikan oleh Pembaca Sumber dan Penulis Sink. Pembaca Sumber dan Penulis Sink telah dioptimalkan untuk Windows 10 dan Windows 11. Microsoft sangat menyarankan agar kode baru menggunakan Pembaca Sumber dan Penulis Sink alih-alih Windows Media Format 11 SDK, jika memungkinkan. Microsoft menyarankan agar kode yang ada yang menggunakan API warisan ditulis ulang untuk menggunakan API baru jika memungkinkan.]

Antarmuka IWMProfile adalah antarmuka utama untuk objek profil . Objek profil digunakan untuk mengonfigurasi profil kustom. Anda dapat menggunakan IWMProfile untuk membuat, menghapus, atau memodifikasi objek konfigurasi aliran dan objek pengecualian bersama. Anda juga dapat mengatur dan mengambil informasi umum tentang profil. Untuk mengakses semua fitur objek profil, Anda harus menggunakan IWMProfile3, yang mewarisi dari IWMProfile dan IWMProfile2.

IWMProfile juga dapat diakses melalui objek pembaca, di mana Anda dapat menggunakannya untuk mendapatkan informasi tentang aliran file yang dimuat di pembaca. Saat mengakses IWMProfile dari pembaca, Anda dapat membuat perubahan pada profil, tetapi tidak ada perubahan yang dapat disimpan ke file. Seringkali berguna untuk menggunakan profil file yang ada sebagai fondasi profil baru. Pembaca sinkron mendukung IWMProfile dengan cara yang sama seperti pembaca.

Informasi profil yang diperoleh melalui pembaca atau pembaca sinkron tidak berasal dari file .prx. Pembaca menggunakan informasi dalam file ASF untuk merakit konfigurasi aliran. Dengan demikian, informasi profil tertentu, seperti nama dan deskripsi, tidak tersedia melalui pembaca.

Ada beberapa cara untuk mendapatkan penunjuk ke antarmuka IWMProfile . Manajer profil memiliki metode untuk membuat profil baru dan mengakses profil yang ada. Semua metode ini menetapkan penunjuk IWMProfile . Saat membaca file, pointer ke IWMProfile dapat diperoleh dengan memanggil metode QueryInterface dari antarmuka pembaca apa pun. Demikian juga, antarmuka objek pembaca sinkron apa pun dapat memperoleh penunjuk dengan panggilan ke QueryInterfaceIWMProfile3.

Anggota

Antarmuka IWMProfile mewarisi dari antarmuka IUnknown . IWMProfile juga memiliki jenis anggota ini:

Metode

Antarmuka IWMProfile memiliki metode ini.

Metode Deskripsi
TambahkanMutualExclusion Menambahkan objek pengecualian timbal balik ke profil.
TambahkanStream Menambahkan aliran ke profil.
CreateNewMutualExclusion Membuat objek pengecualian timbal balik untuk profil.
BuatNewStream Membuat objek konfigurasi aliran untuk profil.
GetDescription Mengambil deskripsi profil.
GetMutualExclusion Mengambil objek pengecualian timbal balik dari profil.
GetMutualExclusionCount Mengambil jumlah objek pengecualian timbal balik di profil.
GetName Mengambil nama profil.
GetStream Mengambil aliran, menggunakan nomor indeks, dari profil.
GetStreamByNumber Mengambil aliran, menggunakan jumlah aliran, dari profil.
GetStreamCount Mengambil jumlah aliran di profil.
GetVersion Mengambil nomor versi Microsoft Windows Media Services di profil.
Konfigurasi UlangStream Memungkinkan perubahan yang dilakukan pada konfigurasi aliran untuk disertakan dalam profil.
RemoveMutualExclusion Menghapus objek pengecualian timbal balik dari profil.
HapusStream Menghapus aliran dari profil.
RemoveStreamByNumber Menghapus aliran dari profil.
SetDescription Menentukan deskripsi profil.
SetName Menentukan nama profil.

Untuk informasi tentang antarmuka mana yang dapat diperoleh dengan menggunakan metode QueryInterface antarmuka ini, lihat topik untuk objek tempat antarmuka ini diterapkan.

Lihat juga

Antarmuka

Antarmuka IWMProfileManager

Objek Manajer Profil

Objek Pembaca

Objek Pembaca Sinkron

Bekerja dengan Profil