IWMPMediaCollection::getAll-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 getAll-Methode gibt eine IWMPPlaylist-Schnittstelle zurück, die der Wiedergabeliste entspricht, die alle Medienelemente in der Bibliothek enthält.

Syntax

public IWMPPlaylist getAll();

Public Function getAll() As IWMPPlaylist
Implements IWMPMediaCollection.getAll

Parameter

Diese Methode hat keine Parameter.

Rückgabewert

Die WMPLib.IWMPPlaylist-Schnittstelle für die Wiedergabeliste, die alle angeforderten Medienelemente enthält.

Bemerkungen

Bevor Sie diese Methode aufrufen, benötigen Sie Lesezugriff auf die Bibliothek. Weitere Informationen finden Sie unter Bibliothekszugriff.

Es gibt zwei Möglichkeiten, eine IWMPMediaCollection-Schnittstelle abzurufen, und das Verhalten der getAll-Methode hängt davon ab, welche dieser beiden Methoden Sie verwenden. Wenn Sie die Schnittstelle durch Aufrufen von AxWindowsMediaPlayer.mediaCollection abrufen, gibt die getAll-Methode alle Medienelemente in der Bibliothek zurück. Wenn Sie jedoch die Schnittstelle abrufen, indem Sie IWMPLibrary.mediaCollection aufrufen, gibt die getAll-Methode nur die Audioelemente in der Bibliothek zurück.

Beispiele

Im folgenden Beispiel wird getAll zum zufälligen Wiedergeben von Medienelementen aus der Mediensammlung verwendet. Das AxWMPLib.AxWindowsMediaPlayer-Objekt wird durch die Variable player dargestellt.

// Create a random number generator. 
System.Random randGenerator = new System.Random();

// Store the count of all media items in the media collection.
int count = player.mediaCollection.getAll().count;

// Get a random integer using the count as the max value.
int rand = randGenerator.Next(count);

// Make the random media item the current media item.
player.currentMedia = player.mediaCollection.getAll().get_Item(rand);

// Play the media item.
player.Ctlcontrols.play();

' Create a random number generator. 
Dim randGenerator As System.Random = New System.Random()

' Store the count of all media items in the media collection.
Dim count As Integer = player.mediaCollection.getAll().count

' Get a random integer using the count as the max value.
Dim rand As Integer = randGenerator.Next(count)

' Make the random media item the current media item.
player.currentMedia = player.mediaCollection.getAll().Item(rand)

' Play the media item.
player.Ctlcontrols.play()

Anforderungen

Anforderung	Wert
Version	Windows Medienwiedergabe Serie 9 oder höher
Namespace	WMPLib
Assembly	Interop.WMPLib.dll (Interop.WMPLib.dll.dll)

Siehe auch

IWMPMediaCollection-Schnittstelle (VB und C#)

IWMPPlaylist-Schnittstelle (VB und C#)