befehl MCI_PLAY
Der MCI_PLAY-Befehl signalisiert dem Gerät, mit der Übertragung von Ausgabedaten zu beginnen. CD-Audio-, Digital-Video-, MIDI-Sequencer-, Videodisc-, VCR- und Waveform-Audiogerä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 für Digitalvideo- und Videorekordergeräte MCI_TEST. Informationen zu diesen Flags finden Sie unter Warte-, Benachrichtigungs- und Testflags.
-
lpPlay
-
Zeiger auf eine MCI_PLAY_PARMS-Struktur . (Geräte mit erweiterten Befehlssätzen können diese Struktur durch eine gerätespezifische Struktur ersetzen.)
Rückgabewert
Gibt null zurück, wenn der Vorgang erfolgreich war oder andernfalls ein Fehler.
Bemerkungen
Die folgenden zusätzlichen Flags gelten für alle Geräte, die MCI_PLAY unterstützen:
-
MCI_FROM
-
Ein Startort ist im dwFrom-Element der durch lpPlay identifizierten Struktur enthalten. Die den Positionswerten zugewiesenen Einheiten werden mit dem MCI_SET_TIME_FORMAT Flag des befehls MCI_SET angegeben. Wenn MCI_FROM nicht angegeben ist, wird der Startort standardmäßig auf die aktuelle Position festgelegt.
-
MCI_TO
-
Ein Endspeicherort ist im dwTo-Element der struktur enthalten, die durch lpPlay identifiziert wurde. Die den Positionswerten zugewiesenen Einheiten werden mit dem MCI_SET_TIME_FORMAT Flag MCI_SET angegeben. Wenn MCI_TO nicht angegeben wird, 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 erneut gestartet werden, wenn das Ende des Inhalts erreicht ist.
-
MCI_DGV_PLAY_REVERSE
-
Die Wiedergabe sollte umgekehrt erfolgen.
-
MCI_MCIAVI_PLAY_WINDOW
-
Die Wiedergabe sollte im Fenster erfolgen, das einem Gerät instance zugeordnet ist (Standard). (Dieses Flag ist spezifisch für MCIAVI. DRV.)
-
MCI_MCIAVI_PLAY_FULLSCREEN
-
Für die Wiedergabe sollte eine Vollbildanzeige verwendet werden. Verwenden Sie dieses Flag nur beim Wiedergeben komprimierter oder 8-Bit-Dateien.
Bei Digitalvideogeräten 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
-
Das dwAt-Element der struktur, die von lpPlay identifiziert wird, enthält einen Zeitpunkt, zu dem der gesamte Befehl beginnt, oder wenn das Gerät angeleitet wird, wenn das Gerät die vom MCI_CUE-Befehl angegebene Position erreicht.
-
MCI_VCR_PLAY_REVERSE
-
Die Wiedergabe sollte umgekehrt erfolgen.
-
MCI_VCR_PLAY_SCAN
-
Die Wiedergabe sollte so schnell wie möglich erfolgen, während die Videoausgabe beibehalten wird.
Bei VCR-Geräten 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
-
Schnell spielen.
-
MCI_VD_PLAY_REVERSE
-
Umgekehrte Wiedergabe.
-
MCI_VD_PLAY_SCAN
-
Schnelle Überprüfung.
-
MCI_VD_PLAY_SLOW
-
Langsam spielen.
-
MCI_VD_PLAY_SPEED
-
Die Wiedergabegeschwindigkeit ist im dwSpeed-Element in der durch lpPlay identifizierten Struktur enthalten.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) |
Windows 2000 Professional [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) |
Windows 2000 Server [nur Desktop-Apps] |
| Header |
|