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 |
|