Метод MediaCollection.getMediaAtom

  • Статья

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

Метод getMediaAtom извлекает индекс, по которому указанный атрибут находится в наборе доступных атрибутов.

Синтаксис

retVal = MediaCollection.getMediaAtom(
  attribute
)

Параметры

attribute [in]

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

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

Этот метод возвращает число (long).

Комментарии

Номер индекса, полученный с помощью этого метода, можно передать на носитель. Метод getItemInfoByAtom для доступа к значениям атрибутов. Этот метод обычно более эффективен при работе с большими списками воспроизведения, чем доступ к значению атрибута по имени через media. getItemInfo или Media. getItemInfoByType.

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

Требования

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

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

Media.getItemInfo

Media.getItemInfoByAtom

Media.getItemInfoByType

Объект MediaCollection

Settings.mediaAccessRights

Settings.requestMediaAccessRights