Метод Media.getItemInfoByType

Статья
06/21/2023

[Функция, связанная с этой страницей, Медиаплеер Windows sdk, является устаревшей функцией. Он был заменен MediaPlayer. MediaPlayer оптимизирован для Windows 10 и Windows 11. Корпорация Майкрософт настоятельно рекомендует по возможности использовать MediaPlayer вместо пакета SDK для Медиаплеер Windows. Корпорация Майкрософт предлагает переписать существующий код, использующий устаревшие API, чтобы по возможности использовать новые API.]

Метод getItemInfoByType извлекает значение атрибута, соответствующее указанному имени атрибута, языку и индексу.

Синтаксис

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

Параметры

name [in]: Строка , содержащая имя атрибута. Сведения об атрибутах, поддерживаемых Медиаплеер Windows, см. в справочнике по атрибутам Медиаплеер Windows.
язык [in]: Строка , представляющая язык. Если задано значение null или "" (пустая строка), используется текущая строка языкового стандарта. В противном случае значение должно быть допустимой строкой языка RFC 1766, например en-us.
index [in]: Число (long), содержащее отсчитываемый от нуля индекс значения, извлекаемого из атрибута.

Возвращаемое значение

Этот метод возвращает объект Number, String, MetadataPicture или MetadataText , как показано в следующей таблице.

attribute	Возвращаемое значение
SyncState	Number (unsigned long)
WM/Lyrics_Synchronised	Объект MetadataText
WM/Picture	Объект MetadataPicture
WM/UserWebURL	Объект MetadataText
Все остальные атрибуты	String

Для атрибутов, базовым значением которых является логическое значение, этот метод возвращает строку true или false.

Этот метод поддерживает атрибуты с несколькими значениями и атрибуты со сложными значениями. Метод getItemInfo не поддерживает атрибуты с несколькими значениями и атрибуты со сложными значениями.

Свойство attributeCount содержит количество имен атрибутов, доступных для данного объекта Media . Затем номера индексов можно использовать с методом getAttributeName , чтобы определить имя каждого доступного атрибута. Отдельные имена атрибутов можно передать в параметр namegetItemInfoByType.

Метод getAttributeCountByType возвращает количество атрибутов, соответствующих определенному имени атрибута для данного объекта Media . Затем номера индекса можно передать в параметр индексаgetItemInfoByType. Это полезно, если цифровой элемент мультимедиа классифицируется по нескольким жанрам, например.

Для использования этого метода требуется доступ на чтение к библиотеке. Дополнительные сведения см. в разделе Доступ к библиотеке.

Этот метод может привести к ошибкам. При вызове этого метода необходимо включить код обработки ошибок. Например, в JScript можно реализовать обработку ошибок с помощью try... Поймать... наконец , структура.

Медиаплеер Windows 10 Mobile: этот метод не поддерживается.

Требования

Требование	Значение
Версия	Медиаплеер Windows серии 9 или более поздней версии.
DLL	Wmp.dll

См. также раздел

Объект media
Media.attributeCount
Media.getAttributeCountByType
Media.getAttributeName
Media.getItemInfo
Media.setItemInfo
Объект MetadataPicture
Объект MetadataText
Чтение значений атрибутов
Settings.mediaAccessRights
Settings.requestMediaAccessRights