Метод Media.getItemInfoByAtom

Статья
06/21/2023

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

Метод getItemInfoByAtom извлекает значение атрибута с указанным номером индекса.

Синтаксис

strRetVal = Media.getItemInfoByAtom(
  index
)

Параметры

index [in]: Число (long), указывающее индекс, по которому данный атрибут находится в наборе доступных атрибутов.

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

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

Этот метод можно использовать для получения метаданных для определенного цифрового элемента мультимедиа с помощью номера индекса атрибута. Свойство attributeCount можно использовать для определения количества атрибутов, доступных для элемента мультимедиа.

Метод getMediaAtom объекта MediaCollection также можно использовать для получения индекса определенного атрибута. Этот метод обычно более эффективен, чем методы getItemInfo или getItemInfoByType при работе с большими списками воспроизведения.

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

Сведения об атрибутах, поддерживаемых Медиаплеер Windows, см. в справочнике по атрибутам Медиаплеер Windows.

Медиаплеер Windows 10 Mobile: атрибуты элемента мультимедиа доступны только во время воспроизведения, если они не получены из элемента через коллекцию мультимедиа.

Требования

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

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

Объект мультимедиа
Media.attributeCount
Media.getItemInfo
Media.getItemInfoByType
Media.setItemInfo
MediaCollection.getMediaAtom
Чтение значений атрибутов
Settings.mediaAccessRights
Settings.requestMediaAccessRights