Befehl "play"

Der Wiedergabebefehl beginnt mit der Wiedergabe eines Geräts. CD-Audio-, Digital-Video-, MIDI-Sequencer-, Videodisc-, VCR- und Waveform-Audiogeräte erkennen diesen Befehl.

Um diesen Befehl zu senden, rufen Sie die mciSendString-Funktion auf, wobei der parameter lpszCommand wie folgt festgelegt ist.

_stprintf_s(
  lpszCommand, 
  TEXT("play %s %s %s"), 
  lpszDeviceID, 
  lpszPlayFlags, 
  lpszFlags
); 

Parameter

lpszDeviceID

Bezeichner eines MCI-Geräts. Dieser Bezeichner oder Alias wird zugewiesen, wenn das Gerät geöffnet wird.

lpszPlayFlags

Flag für die Wiedergabe eines Geräts. In der folgenden Tabelle sind Gerätetypen aufgeführt, die den Wiedergabebefehl und die von jedem Typ verwendeten Flags erkennen.

Wert	Bedeutung	Bedeutung
cdaudio	von Position	zu positionieren
digitalvideo	Aus PositionVollbild wiederholen	Fenster umkehren zu positionieren
sequencer	von Position	zu positionieren
Vcr	zeitpunktvon positionreverse	Scannen an Position
videodisc	Schnelle Umgekehrte Überprüfung von Position	Ganzzahlige Langsamgeschwindigkeitauf Position
Waveaudio	von Position	zu positionieren

In der folgenden Tabelle sind die Flags aufgeführt, die im lpszPlayFlags-Parameter angegeben werden können, und ihre Bedeutungen.

Wert	Bedeutung
Zur Zeit	Gibt an, wann das Gerät mit der Ausführung dieses Befehls beginnen soll, oder, wenn das Gerät als Cued bezeichnet wurde, wann der Befehl "cued" beginnt. Weitere Informationen finden Sie im Befehl cue .
fast	Gibt an, dass das Gerät schneller als normal wiedergegeben werden soll. Um die genaue Geschwindigkeit auf einem Videodisc-Player zu bestimmen, verwenden Sie das "Speed"-Flag des befehls status. Um die Geschwindigkeit genauer anzugeben, verwenden Sie das "Speed"-Flag dieses Befehls.
von Position	Gibt eine Startposition für die Wiedergabe an. Wenn das Flag "from" nicht angegeben ist, beginnt die Wiedergabe an der aktuellen Position. Wenn bei cdaudio-Geräten die Position "von" größer als die Endposition des Datenträgers ist oder wenn die Position "von" größer als die Position "bis" ist, gibt der Treiber einen Fehler zurück. Bei Videodisc-Geräten befinden sich die Standardpositionen in Frames für CAV-Datenträger und in Stunden, Minuten und Sekunden für CLV-Datenträger.
Fullscreen	Gibt an, dass eine Vollbildanzeige verwendet werden soll. Verwenden Sie dieses Flag nur beim Wiedergeben komprimierter Dateien. (Nicht komprimierte Dateien werden nicht im Vollbildmodus wiedergegeben.)
wiederholen	Gibt an, dass die Wiedergabe neu gestartet werden soll, wenn das Ende des Inhalts erreicht ist.
reverse	Gibt an, dass die Wiedergaberichtung rückwärts ist. Sie können keine Endposition mit dem Flag "reverse" angeben. Bei Videodiscs gilt "Scan" nur für das CAV-Format.
scan	Wird so schnell wie möglich wiedergegeben, ohne das Video zu deaktivieren (obwohl audio möglicherweise deaktiviert ist). Bei Videodiscs gilt "Scan" nur für das CAV-Format.
langsam	Spielt langsam ab. Um die genaue Geschwindigkeit auf einem Videodisc-Player zu bestimmen, verwenden Sie das "Speed"-Flag des befehls status. Um die Geschwindigkeit genauer anzugeben, verwenden Sie das "Speed"-Flag dieses Befehls. Bei Videodiscs gilt "langsam" nur für das CAV-Format.
ganzzahlige Geschwindigkeit	Gibt eine Videodisc mit der angegebenen Geschwindigkeit in Frames pro Sekunde ab. Dieses Flag gilt nur für CAV-Datenträger.
zu positionieren	Gibt eine Endposition für die Wiedergabe an. Wenn das "an"-Flag nicht angegeben ist, wird die Wiedergabe am Ende des Inhalts beendet. Wenn bei cdaudio-Geräten die Position "bis" größer als die Endposition des Datenträgers ist, gibt der Treiber einen Fehler zurück. Bei Videodisc-Geräten befinden sich die Standardpositionen in Frames für CAV-Datenträger und in Stunden, Minuten und Sekunden für CLV-Datenträger.
Fenster	Gibt an, dass die Wiedergabe das Fenster verwenden soll, das dem instance gerät zugeordnet ist. Dies ist die Standardeinstellung.

lpszFlags

Kann "warten", "benachrichtigen" oder beides sein. Für Digitalvideo- und Videorekordergeräte kann auch "Test" angegeben werden. Weitere Informationen zu diesen Flags finden Sie unter Warte-, Benachrichtigungs- und Testflags.

Rückgabewert

Gibt null zurück, wenn der Vorgang erfolgreich war oder andernfalls ein Fehler.

Bemerkungen

Bevor Sie Befehle ausgeben, die Positionswerte verwenden, sollten Sie das gewünschte Zeitformat mithilfe des Befehls set festlegen. Dieser Befehl beginnt mit der aktuellen Geschwindigkeit zu spielen, wie sie mit dem Befehl "speed" festgelegt ist. Die Richtung ist umgekehrt, wenn das Flag "reverse" angegeben wird, oder wenn das "to"-Flag als wert kleiner als das Flag "from" angegeben wird. Wenn das Flag "from" nicht angegeben ist, beginnt die Wiedergabe an der aktuellen Position. Die Flags "to" und "reverse" können nicht zusammen verwendet werden.

Beispiele

Der folgende Befehl gibt das Gerät "mysound" von Position 1000 bis Position 2000 ab und sendet eine Benachrichtigung, wenn die Wiedergabe abgeschlossen ist.

play mysound from 1000 to 2000 notify

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]

Siehe auch

MCI

MCI-Befehlszeichenfolgen

Hinweis

set