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

Die Play-Methode beginnt mit der Wiedergabe an der aktuellen Suchposition. Wenn die 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 Streaming-Audiowiedergabe (Streaming von Audiodaten vom Computer des Benutzers auf das Mediengerät, wo sie wiedergegeben werden) aufzurufen. Die Seek-Methode bestimmt die Art der Wiedergabe, die stattfindet.

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

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

Anforderungen

Anforderung Wert
Zielplattform Windows
Kopfzeile mswmdm.h
Bibliothek Mssachlp.lib

Weitere Informationen

IMDSPDevice::GetFormatSupport

IMDSPDeviceControl-Schnittstelle

IMDSPDeviceControl::GetCapabilities

IMDSPDeviceControl::Seek