Método MediaCollection.getPlaylistByQuery

[O recurso associado a esta página, Reprodutor Multimídia do Windows SDK, é um recurso herdado. Foi substituído pelo MediaPlayer. O MediaPlayer foi otimizado para Windows 10 e Windows 11. A Microsoft recomenda fortemente que o novo código use o MediaPlayer em vez de Reprodutor Multimídia do Windows SDK, quando possível. A Microsoft sugere que o código existente que usa as APIs herdadas seja reescrito para usar as novas APIs, se possível.]

O método getPlaylistByQuery recupera um objeto Playlist que contém objetos Media que correspondem às condições de consulta.

Sintaxe

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

Parâmetros

consulta [in]

Objeto de consulta que define as condições usadas para criar a playlist.

mediaType [in]

Cadeia de caracteres que contém o tipo de mídia. Deve conter um dos seguintes valores: "áudio", "vídeo", "foto", "playlist" ou "outro".

sortAttribute [in]

Cadeia de caracteres que contém o nome do atributo usado para classificação. Uma cadeia de caracteres vazia ("") significa que nenhuma classificação é aplicada.

sortAscending [in]

Booliano, true indicando que a playlist deve ser classificada em ordem crescente.

Retornar valor

Esse método retorna um objeto Playlist .

Comentários

Consultas compostas usando Consulta não diferenciam maiúsculas de minúsculas.

Quando a consulta composta especificada pelo parâmetro de consulta contém uma condição criada no atributo MediaType , essa condição é ignorada. O valor do parâmetro mediaType é sempre usado. Por exemplo, se a consulta composta contiver a condição "MediaType Equals audio" e o valor do parâmetro mediaType for "video", a playlist resultante conterá apenas itens de vídeo.

Requisitos

Requisito	Valor
Versão	Reprodutor Multimídia do Windows 11.
DLL	Wmp.dll

Confira também

Objeto MediaCollection

Atributo MediaType

Objeto Query