Метод Media.getMarkerName

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

Метод getMarkerName извлекает имя маркера по указанному индексу.

Синтаксис

strRetVal = Media.getMarkerName(
  markerNum
)

Параметры

markerNum [in]

Число (long), указывающее индекс маркера.

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

Этот метод возвращает объект String.

Комментарии

Этот метод возвращает значение NULL , если указанный маркер не существует.

Некоторые элементы мультимедиа не содержат маркеров. Используйте параметр markerCount , чтобы узнать, сколько маркеров находится в текущем клипе.

Номера индекса маркера начинаются с 1.

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

Примеры

В следующем примере JScript используется media. getMarkerName для заполнения элемента HTML TEXTAREA с именем MNAMES именами маркеров в текущем элементе мультимедиа. Объект Player был создан с идентификатором " Player".

// Get the number of markers in the current media item.
var mcount = Player.currentMedia.markerCount;

// Verify that at least one marker exists in the current media.
if (mcount > 0){

// Loop through the marker list.
for (var i = 1; i < mcount + 1; i++){

   // Print the marker name to the text area.
   MNAMES.value += Player.currentMedia.getMarkerName(i);
   MNAMES.value += "\n";
}

Требования

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

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

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

Media.getMarkerTime

Media.markerCount

Settings.mediaAccessRights

Settings.requestMediaAccessRights