MediaCollection.getPlaylistByQuery-Methode

[Das dieser Seite zugeordnete Feature Windows Medienwiedergabe SDK ist ein Legacyfeature. Es wurde von MediaPlayer ersetzt. MediaPlayer wurde für Windows 10 und Windows 11 optimiert. Microsoft empfiehlt dringend, nach Möglichkeit für neuen Code MediaPlayer anstelle von Windows Medienwiedergabe SDK zu verwenden. Microsoft schlägt vor, vorhandenen Code, der die Legacy-APIs verwendet, um nach Möglichkeit die neuen APIs zu verwenden.]

Die getPlaylistByQuery-Methode ruft ein Wiedergabelistenobjekt ab, das Media-Objekte enthält, die den Abfragebedingungen entsprechen.

Syntax

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

Parameter

Abfrage [in]

Abfrageobjekt , das die Bedingungen definiert, die zum Erstellen der Wiedergabeliste verwendet werden.

mediaType [in]

Zeichenfolge , die den Medientyp enthält. Muss einen der folgenden Werte enthalten: "audio", "video", "photo", "playlist" oder "other".

sortAttribute [in]

Zeichenfolge mit dem Attributnamen, der für die Sortierung verwendet wird. Eine leere Zeichenfolge ("") bedeutet, dass keine Sortierung angewendet wird.

sortAscending [in]

Boolesch, true, der angibt, dass die Wiedergabeliste in aufsteigender Reihenfolge sortiert werden muss.

Rückgabewert

Diese Methode gibt ein Playlist-Objekt zurück.

Bemerkungen

Bei zusammengesetzten Abfragen mit Query wird die Groß-/Kleinschreibung nicht beachtet.

Wenn die durch den Abfrageparameter angegebene zusammengesetzte Abfrage eine Bedingung enthält, die auf dem MediaType-Attribut basiert, wird diese Bedingung ignoriert. Der Wert für den mediaType-Parameter wird immer verwendet. Wenn die zusammengesetzte Abfrage beispielsweise die Bedingung "MediaType Gleich Audio" und der Wert für den mediaType-Parameter "video" enthält, enthält die resultierende Wiedergabeliste nur Videoelemente.

Anforderungen

Anforderung	Wert
Version	Windows Medienwiedergabe 11.
DLL	Wmp.dll

Siehe auch

MediaCollection-Objekt

MediaType-Attribut

Abfrageobjekt