MCI _ PLAY-Befehl

Der MCI _ PLAY-Befehl signalisiert dem Gerät, mit der Übertragung von Ausgabedaten zu beginnen. CD-Audio, digital-video, KEYBOARD sequencer, videodisc, VCR und waveform-audio-Geräte erkennen diesen Befehl.

Um diesen Befehl zu senden, rufen Sie die mciSendCommand-Funktion mit den folgenden Parametern auf.

MCIERROR mciSendCommand(
  MCIDEVICEID wDeviceID, 
  MCI_PLAY, 
  DWORD dwFlags, 
  (DWORD) (LPMCI_PLAY_PARMS ) lpPlay
);

Parameter

wDeviceID

Gerätebezeichner des MCI-Geräts, das die Befehlsnachricht empfangen soll.

Dwflags

MCI _ NOTIFY, MCI _ WAIT oder bei Digitalvideo- und VCR-Geräten MCI _ TEST. Informationen zu diesen Flags finden Sie unter Die Warte-, Benachrichtigungs- und Testflags.

lpPlay

Zeiger auf eine MCI _ PLAY _ PARMS-Struktur. (Geräte mit erweiterten Befehlssätzen ersetzen diese Struktur möglicherweise durch eine gerätespezifische Struktur.)

Rückgabewert

Gibt 0 (null) zurück, wenn erfolgreich, andernfalls ein Fehler.

Bemerkungen

Die folgenden zusätzlichen Flags gelten für alle Geräte, die MCI _ PLAY unterstützen:

MCI _ FROM

Eine Startposition ist im dwFrom-Member der struktur enthalten, die durch lpPlay identifiziert wird. Die einheiten, die den Positionswerten zugewiesen sind, werden mit dem MCI _ SET TIME FORMAT-Flag des _ _ MCI _ SET-Befehls angegeben. Wenn MCI FROM nicht angegeben ist, wird standardmäßig die aktuelle _ Position als Startposition verwendet.

MCI _ TO

Eine Endposition ist im dwTo-Member der -Struktur enthalten, die durch lpPlay identifiziert wird. Die den Positionswerten zugewiesenen Einheiten werden mit dem MCI _ SET _ TIME _ FORMAT-Flag von MCI _ SET angegeben. Wenn MCI TO nicht angegeben ist, wird der Endspeicherort _ standardmäßig auf das Ende des Mediums festgelegt.

Die folgenden zusätzlichen Flags werden mit dem Gerätetyp digitalvideo verwendet:

MCI _ DGV _ PLAY _ REPEAT

Die Wiedergabe sollte am Anfang wieder gestartet werden, wenn das Ende des Inhalts erreicht ist.

MCI _ DGV _ PLAY _ REVERSE

Die Wiedergabe sollte umgekehrt erfolgen.

MCI _ MCIAVI _ _ PLAY-FENSTER

Die Wiedergabe sollte in dem Fenster erfolgen, das einer Geräteinstanz zugeordnet ist (Standardeinstellung). (Dieses Flag ist spezifisch für MCIAVI. DRV.)

MCI _ MCIAVI _ PLAY _ FULLSCREEN

Bei der Wiedergabe sollte eine Vollbildanzeige verwendet werden. Verwenden Sie dieses Flag nur bei der Wiedergabe komprimierter oder 8-Bit-Dateien.

Für Digitalvideogeräte verweist lpPlay auf eine MCI _ DGV _ PLAY _ PARMS-Struktur.

Die folgenden zusätzlichen Flags werden mit dem vcr-Gerätetyp verwendet:

MCI _ VCR _ PLAY _ AT

Der dwAt-Member der durch lpPlay identifizierten Struktur enthält einen Zeitpunkt, zu dem der gesamte Befehl beginnt oder wenn das Gerät mit einem Cued-Befehl auftatiert wird, wenn das Gerät von der vom MCI _ CUE-Befehl angegebenen Position erreicht wird.

MCI _ VCR _ PLAY _ REVERSE

Die Wiedergabe sollte umgekehrt erfolgen.

MCI _ VCR _ PLAY _ SCAN

Die Wiedergabe sollte so schnell wie möglich sein und gleichzeitig die Videoausgabe beibehalten.

Für VCR-Geräte verweist lpPlay auf eine MCI _ VCR _ PLAY _ PARMS-Struktur.

Die folgenden zusätzlichen Flags werden mit dem Videodisc-Gerätetyp verwendet:

MCI _ VD _ PLAY _ FAST

Spielen Sie schnell.

MCI _ VD _ PLAY _ REVERSE

Wiedergabe in umgekehrter Reihenfolge.

MCI _ VD _ PLAY _ SCAN

Schnelle Überprüfung.

MCI _ VD _ PLAY _ SLOW

Spielen Sie langsam.

MCI _ VD _ PLAY _ SPEED

Die Wiedergabegeschwindigkeit ist im dwSpeed-Member in der struktur enthalten, die durch lpPlay identifiziert wird.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client)
Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)
Windows 2000 Server [nur Desktop-Apps]
Header
Mmsystem.h (include Windows.h)

Siehe auch

MCI

MCI-Befehle