Метод Media.getItemInfo

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

Метод getItemInfo извлекает значение указанного атрибута для текущего элемента мультимедиа.

Синтаксис

strRetVal = Media.getItemInfo(
  name
)

Параметры

name [in]

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

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

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

Комментарии

Этот метод извлекает метаданные для отдельного элемента мультимедиа или элемента мультимедиа, который является частью списка воспроизведения.

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

Чтобы получить атрибуты с несколькими значениями и атрибуты со сложными значениями, используйте метод getItemInfoByType .

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

Чтобы предоставить общий доступ к библиотекам мультимедиа Windows через UPnP, Медиаплеер Windows создает службу каталогов содержимого (CDS), которая предоставляется через UPnP. Затем другие устройства могут перемещаться по библиотекам и просматривать их.

В Windows 7 приложение может использовать атрибуты TrackingID и MediaType Медиаплеер Windows для создания идентификатора объекта каждого элемента в CDS. Обратите внимание, что эта конструкция может измениться в будущих версиях Windows. Приложение передает каждую из этих строк атрибута в параметре name в вызове метода getItemInfo. GetItemInfo возвращает значение для каждого атрибута в возвращаемом значении. Затем приложение использует следующий синтаксис для создания каждого идентификатора объекта:

TrackingID.0. MediaTypeID

Этот синтаксис имеет следующее значение:

• TrackingID — это строка, которая хранится в атрибуте Медиаплеер Windows TrackingID элемента мультимедиа.

• MediaTypeID зависит от значения атрибута MediaType , как показано в следующей таблице:

  Атрибут MediaType	MediaTypeID
  Звуковые элементы	4
  Элементы фотографий	B
  Элементы видео	8

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

Требования

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

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

Объект мультимедиа

Media.attributeCount

Media.getAttributeName

Media.getItemInfoByType

Media.setItemInfo

Чтение значений атрибутов

Settings.mediaAccessRights

Settings.requestMediaAccessRights