IWMDMDeviceControl::P lay-Methode (mswmdm.h)

Artikel
03/04/2024

Die Play-Methode beginnt mit der Wiedergabe an der aktuellen Suchposition. Wenn die IWMDMDeviceControl::Seek-Methode nicht aufgerufen wurde, beginnt die Wiedergabe am Anfang der ersten Datei, und die Wiedergabelänge ist nicht definiert.

Syntax

HRESULT Play();

Rückgabewert

Die Methode gibt ein HRESULT zurück. Mögliches Werte (aber nicht die Einzigen) sind die in der folgenden Tabelle.

Rückgabecode	BESCHREIBUNG
S_OK	Die Methode wurde erfolgreich ausgeführt.
E_BUSY	Das Gerät ist ausgelastet.
WMDM_E_NOTSUPPORTED	Die Wiedergabefunktion ist auf diesem Gerät nicht implementiert.
E_FAIL	Es ist ein unbekannter Fehler aufgetreten.

Hinweise

Diese Methode wird verwendet, um sowohl die Gerätewiedergabe (Wiedergabe einer Audiospur auf einem Speichermedium des Mediengeräts) als auch die Audiowiedergabe im Streaming (Streaming von Audiodaten vom Computer des Benutzers auf das Mediengerät, wo sie wiedergegeben werden) aufzurufen. Die Seek-Methode bestimmt die Art der Wiedergabe.

Einige Geräte unterstützen weder die Gerätewiedergabe noch die Streaming-Audiowiedergabe. Bevor Sie versuchen, die Wiedergabe eines bestimmten Typs zu starten, muss die GetCapabilities-Methode aufgerufen werden. Wenn die nicht unterstützte Wiedergabe versucht wird, gibt diese Methode WMDM_E_NOTSUPPORTED zurück.

Um vor dem Aufrufen des Wiedergabevorgangs zu bestimmen, ob ein Audioformat vom Mediengerät wiedergegeben werden kann, können Sie die GetFormatSupport-Methode aufrufen.