MCI _ CUE-Befehl

Der MCI _ CUE-Befehl spricht von einem Gerät, sodass die Wiedergabe oder Aufzeichnung mit minimaler Verzögerung beginnt. Digital-Video-, 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_CUE, 
  DWORD dwFlags, 
  (DWORD) (LPMCI_GENERIC_PARMS) lpCue
);

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.

lpCue

Zeiger auf eine MCI _ GENERIC _ 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 werden mit dem Gerätetyp digitalvideo verwendet:

MCI _ DGV _ CUE _ INPUT

Eine Digital-Video-Instanz sollte sich auf die Aufzeichnung vorbereiten. Wenn die Anwendung keinen reservierten Speicherplatz auf dem Datenträger hat, reserviert das Gerät den Speicherplatz mithilfe seiner Standardparameter. Die Anwendung kann dieses Flag weglassen, wenn die aktuelle Präsentationsquelle bereits die externe Eingabe ist. (Dieses Flag hat keine Auswirkungen auf die Auswahl der Präsentationsquelle.)

MCI _ DGV _ CUE _ NOSHOW

Eine digital-video-Instanz sollte sich auf die Wiedergabe des mit dem Befehl angegebenen Frames vorbereiten, ohne ihn anzuzeigen. Wenn dieses Flag angegeben wird, zeigt die Anzeige weiterhin das Bild im Framepuffer an, obwohl der entsprechende Frame nicht die aktuelle Position ist. Wenn der Framepuffer beispielsweise das Bild aus Frame 7 enthält, zeigt das Gerät weiterhin Frame 7 an, wenn dieses Flag verwendet wird, um das Gerät auf eine andere Position zu bringen. Ein nachfolgender Cue-Befehl ohne dieses Flag und ohne das MCI _ TO-Flag zeigt den aktuellen Frame an.

MCI _ DGV _ _ CUE-AUSGABE

Eine Digitale Videoinstanz sollte sich auf die Wiedergabe vorbereiten. Wenn der Arbeitsbereich angehalten wird, erfolgt keine Positionierung. Wenn der Arbeitsbereich beendet wird, ändert sich die Position möglicherweise in ein vorheriges Keyframebild. Die Anwendung kann dieses Flag weglassen, wenn die aktuelle Präsentationsquelle bereits der Arbeitsbereich ist.

MCI _ TO

Eine Arbeitsbereichsposition ist im dwTo-Member der struktur enthalten, die durch lpCue identifiziert wird. Die Einheiten, die Positionswerten zugewiesen sind, werden mithilfe des MCI _ SET _ TIME _ FORMAT-Flags des MCI _ SET-Befehls angegeben. Dies entspricht der Suche nach einer Position, mit der Ausnahme, dass das Gerät nach dem Befehl angehalten wird.

Bei digitalvideo-Geräten verweist der lpCue-Parameter auf eine MCI _ DGV _ CUE _ PARMS-Struktur.

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

MCI _ FROM

Der dwFrom-Member der -Struktur, auf die lpCue zeigt, enthält die Startposition, die im aktuellen Zeitformat angegeben ist.

MCI _ TO

Der dwTo-Member der -Struktur, auf die lpCue zeigt, enthält die Endposition (anhaltend), die im aktuellen Zeitformat angegeben ist.

_ _ MCI-VCR-CUE-EINGABE _

Bereiten Sie die Aufzeichnung vor.

MCI _ VCR _ CUE _ OUTPUT

Bereiten Sie sich auf die Wiedergabe vor. Wenn weder MCI _ VCR _ CUE _ INPUT noch MCI _ VCR _ CUE OUTPUT angegeben ist, wird die _ MCI _ VCR _ CUE OUTPUT _ angenommen.

MCI _ VCR _ CUE _ PREROLL

Bringen Sie das Gerät auf die aktuelle Position oder die dwFrom-Position abzüglich der Dauer der Vorabrollzeit. Dadurch kann sich das Gerät vorbereiten, bevor es in den Aufzeichnungs- oder Wiedergabemodus eintritt.

MCI _ VCR _ CUE _ REVERSE

Die Richtung des nächsten Wiedergabe- oder Datensatzbefehls ist umgekehrt.

Wenn Sie hinweise zur Wiedergabe mithilfe des MCI CUE-Befehls mit dem MCI VCR CUE OUTPUT-Flag verwenden, können Sie MCI CUE abbrechen, indem Sie den MCI PLAY-Befehl mit _ _ _ _ _ MCI FROM, MCI TO oder _ _ _ MCI _ VCR _ PLAY REVERSE _ ausführen.

Wenn Sie hinweise zur Aufzeichnung mithilfe von MCI CUE mit dem MCI VCR CUE INPUT-Flag verwenden, können Sie MCI CUE abbrechen, indem Sie den MCI RECORD-Befehl mit _ _ _ _ _ MCI FROM, MCI TO oder _ _ _ MCI _ VCR _ RECORD INITIALIZE _ ausstellen.

Bei vcr-Geräten verweist der lpCue-Parameter auf eine MCI _ VCR _ CUE _ PARMS-Struktur.

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

MCI _ WAVE _ INPUT

Ein Waveform-Audio-Eingabegerät sollte als Cuing verwendet werden.

MCI _ _ WAVE-AUSGABE

Ein Waveform-Audio-Ausgabegerät sollte cued sein. Dies ist das Standardflag, wenn kein Flag angegeben ist.

Requirements (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)

Weitere Informationen

MCI

MCI-Befehle