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	Mmsystem.h (einschließlich Windows.h)

Siehe auch

MCI

MCI-Befehle