cue-Befehl

  • Artikel

Der Cue-Befehl bereitet sich auf die Wiedergabe oder Aufzeichnung vor. Digital-Video-, Video- und Waveform-Audiogeräte erkennen diesen Befehl.

Um diesen Befehl zu senden, rufen Sie die mciSendString-Funktion auf, wobei der parameter lpszCommand wie folgt festgelegt ist.

_stprintf_s(
  lpszCommand, 
  TEXT("cue %s %s %s"), 
  lpszDeviceID, 
  lpszInOutTo, 
  lpszFlags
);

Parameter

lpszDeviceID

Bezeichner eines MCI-Geräts. Dieser Bezeichner oder Alias wird zugewiesen, wenn das Gerät geöffnet wird.

lpszInOutTo

Flag, das ein Gerät für die Wiedergabe oder Aufzeichnung vorbereitet. In der folgenden Tabelle sind Gerätetypen aufgeführt, die den Cue-Befehl und die von jedem Typ verwendeten Flags erkennen.

Wert Position (Cue) Position (Cue)
digitalvideo
  • input
  • Noshow
  • output
  • zu positionieren
Vcr
  • von Position
  • input
  • output
  • Preroll
  • reverse
  • zu positionieren
Waveaudio input output

In der folgenden Tabelle sind die Flags aufgeführt, die im lpszInOutTo-Parameter angegeben werden können, und deren Bedeutung.

Wert Bedeutung
von Position Gibt an, wo begonnen werden soll.
input Bereitet sich auf die Aufzeichnung vor. Bei Digitalvideogeräten kann dieses Flag weggelassen werden, wenn die aktuelle Präsentationsquelle bereits die externe Eingabe ist.
Noshow Bereitet die Wiedergabe eines Frames vor, ohne ihn anzuzeigen. Wenn dieses Flag angegeben ist, zeigt die Anzeige weiterhin das Bild im Framepuffer an, obwohl der entsprechende Frame nicht die aktuelle Position ist. Ein nachfolgender Cue-Befehl ohne dieses Flag und ohne das Flag "an" zeigt den aktuellen Frame an.
output Bereitet sich auf das Spielen vor. Wenn weder "input" noch "output" angegeben ist, lautet die Standardeinstellung "output".
Preroll Verschiebt den Abstand der Preroll vom In-Point. Der Punkt ist die aktuelle Position oder die durch das Flag "from" angegebene Position.
reverse Gibt an, dass die Wiedergaberichtung umgekehrt (rückwärts) ist.
zu positionieren Verschiebt den Arbeitsbereich an die angegebene Position. Bei VcR-Geräten gibt dieses Flag an, wo angehalten werden soll.

lpszFlags

Kann "warte", "benachrichtigen" oder beides sein. Für Digital-Video- und VcR-Geräte kann auch "Test" angegeben werden. Weitere Informationen zu diesen Flags finden Sie unter Die Warte-, Benachrichtigungs- und Testflags.

Rückgabewert

Gibt null zurück, wenn erfolgreich oder andernfalls ein Fehler auftritt.

Bemerkungen

Obwohl dies nicht erforderlich ist, kann das Ausgeben des Cue-Befehls vor der Wiedergabe oder Aufzeichnung auf einigen Geräten die Verzögerung verringern, bevor das Gerät die Aktion startet.

Dieser Befehl schlägt fehl, wenn die Wiedergabe oder Aufzeichnung ausgeführt wird oder das Gerät angehalten wird.

Beim Anzeigen für die Wiedergabe (mit dem Hinweis "ausgabe") wird der Cue-Befehl abgebrochen, wenn der Wiedergabebefehl mit dem Flag "from", "to" oder "reverse" ausgegeben wird.

Wenn sie für die Aufzeichnung (mit dem Hinweis "eingabe") hinweisen, wird der Cue-Befehl beim Ausgeben des Datensatzbefehls mit dem Flag "from", "to" oder "initialize" abgebrochen.

Beispiele

Der folgende Befehl bereitet das Gerät "mysound" für die Aufzeichnung vor.

cue mysound input

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client)
 Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)
 Windows 2000 Server [nur Desktop-Apps]

Siehe auch

MCI

MCI-Befehlszeichenfolgen

play

record