Metode Media.getItemInfoByType

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

Metode getItemInfoByType mengambil nilai atribut yang sesuai dengan nama atribut, bahasa, dan indeks yang ditentukan.

Sintaks

retVal = Media.getItemInfoByType(
  name,
  language,
  index
)

Parameter

name [in]

String yang berisi nama atribut . Untuk informasi tentang atribut yang didukung oleh Pemutar Media Windows, lihat Referensi Atribut Pemutar Media Windows.

bahasa [dalam]

String yang mewakili bahasa. Jika nilai diatur ke null atau "" (string kosong) string lokal saat ini digunakan. Jika tidak, nilainya harus berupa string bahasa RFC 1766 yang valid seperti "en-us".

index [in]

Angka (panjang) yang berisi indeks nilai berbasis nol untuk diambil dari atribut .

Mengembalikan nilai

Metode ini mengembalikan objek Angka, String, MetadataPicture , atau MetadataText seperti yang ditunjukkan dalam tabel berikut.

Atribut	Nilai kembali
SyncState	Angka (panjang tidak ditandatangani)
WM/Lyrics_Synchronised	Objek MetadataText
WM/Gambar	Objek MetadataPicture
WM/UserWebURL	Objek MetadataText
Semua atribut lainnya	String

Untuk atribut yang nilai yang mendasarnya adalah Boolean, metode ini mengembalikan string "true" atau "false".

Keterangan

Metode ini mengambil metadata untuk item media digital individual atau item media yang merupakan bagian dari daftar putar.

Metode ini mendukung atribut dengan beberapa nilai dan atribut dengan nilai kompleks. Metode getItemInfo tidak mendukung atribut dengan beberapa nilai dan atribut dengan nilai kompleks.

Properti attributeCount berisi jumlah nama atribut yang tersedia untuk objek Media tertentu. Nomor indeks kemudian dapat digunakan dengan metode getAttributeName untuk menentukan nama setiap atribut yang tersedia. Nama atribut individual dapat diteruskan ke parameter namagetItemInfoByType.

Metode getAttributeCountByType mengembalikan jumlah atribut yang sesuai dengan nama atribut tertentu untuk objek Media tertentu. Nomor indeks kemudian dapat diteruskan ke parameter indeksgetItemInfoByType. Ini berguna ketika item media digital telah dikategorikan di bawah beberapa genre, misalnya.

Untuk menggunakan metode ini, diperlukan akses baca ke pustaka. Untuk informasi selengkapnya, lihat Akses Pustaka.

Metode ini dapat menyebabkan kesalahan. Anda harus menyertakan kode penanganan kesalahan saat memanggil metode ini. Misalnya, di JScript Anda dapat menerapkan penanganan kesalahan dengan menggunakan coba... Menangkap... akhirnya struktur.

Pemutar Media Windows 10 Seluler: Metode ini tidak didukung.

Persyaratan

Persyaratan	Nilai
Versi	Pemutar Media Windows Seri 9 atau yang lebih baru.
DLL	Wmp.dll

Lihat juga

Objek Media

Media.attributeCount

Media.getAttributeCountByType

Media.getAttributeName

Media.getItemInfo

Media.setItemInfo

Objek MetadataPicture

Objek MetadataText

Membaca Nilai Atribut

Settings.mediaAccessRights

Settings.requestMediaAccessRights