Метод MediaCollection.getPlaylistByQuery

  • Статья

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

Метод getPlaylistByQuery извлекает объект playlist , содержащий объекты Media , соответствующие условиям запроса.

Синтаксис

retVal = MediaCollection.getPlaylistByQuery(
  query,
  mediaType,
  sortAttribute,
  sortAscending
)

Параметры

query [in]

Объект запроса , определяющий условия, используемые для создания списка воспроизведения.

mediaType [in]

Строка , содержащая тип носителя. Должен содержать одно из следующих значений: "audio", "video", "photo", "playlist" или "other".

sortAttribute [in]

Строка , содержащая имя атрибута, используемого для сортировки. Пустая строка ("") означает, что сортировка не применяется.

sortAscending [in]

Логическое значение, значение true, указывающее, что список воспроизведения должен быть отсортирован по возрастанию.

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

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

Комментарии

Составные запросы, использующие запросы, не чувствительны к регистру.

Если составной запрос, заданный параметром запроса , содержит условие, созданное на основе атрибута MediaType , это условие игнорируется. Всегда используется значение параметра mediaType . Например, если составной запрос содержит условие "MediaType Equals audio", а параметр mediaType имеет значение "video", итоговый список воспроизведения будет содержать только элементы видео.

Требования

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

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

Объект MediaCollection

Атрибут MediaType

Объект запроса