seek-Befehl

Der Seek-Befehl wird an die angegebene Position verschoben und beendet. CD-Audio-, Digital-Video-, SINUS Sequencer-, VCR-, Videodisc- und Waveform-Audio-Geräte erkennen diesen Befehl.

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

_stprintf_s(
  lpszCommand, 
  TEXT("seek %s %s %s"), 
  lpszDeviceID, 
  lpszSeekFlags, 
  lpszFlags
); 

Parameter

lpszDeviceID

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

lpszSeekFlags

Flag für das Verschieben an eine angegebene Position. In der folgenden Tabelle sind die Gerätetypen aufgeführt, die den Suchbefehl und die von den einzelnen Typen verwendeten Flags erkennen.

Wert Bedeutung Bedeutung
cdaudio to end to position , um zu starten
digitalvideo to end to position , um zu starten
sequencer to end to position , um zu starten
Vcr Zur Zeit _ markierungsmarkierung num reverse to end to position to start
videodisc Reverse-to-End , um zu beginnen
Waveaudio to end to position , um zu starten

Die folgende Tabelle enthält die Flags, die im lpszSeekFlags-Parameter angegeben werden können, und ihre Bedeutungen.

Wert Bedeutung
zur zeit Gibt an, wann das Gerät mit der Ausführung dieses Befehls beginnen soll, oder, wenn das Gerät angekuppelt wurde, wenn der Cued-Befehl beginnt. Weitere Informationen finden Sie im Befehl cue.
mark mark _ num Sucht nach der relativen Markierung, die durch die Markierung _ num angegeben wird, die ein positiver ganzzahliger Wert sein muss. Markierungen sind Signale, die mithilfe des Markierungsbefehls auf das VCR-Band geschrieben werden und für die schnelle Suche verwendet werden.
reverse Gibt an, dass die Suchrichtung für VCRs und CAV-Videodiscs rückwärts ist. Dieses Flag ist ungültig, wenn das Flag "to" angegeben ist. Für VCRs muss dieses Flag mit dem Flag "mark" verwendet werden.
to end Sucht bis zum Ende des Inhalts.
, um zu positionieren Gibt die Position an, an der die Suche beendet werden soll. Bei cdaudio-Geräten gibt MCI einen Fehler außerhalb des Bereichs zurück, wenn die angegebene Position größer als die Länge des Datenträgers ist.
, um zu starten Sucht bis zum Anfang des Inhalts.

lpszFlags

Kann "wait", "notify" oder beides sein. Für DigitalVideo- 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 0 (null) zurück, wenn der Fehler erfolgreich war, oder andernfalls ein Fehler.

Bemerkungen

Bevor Sie Befehle ausgeben, die Positionswerte verwenden, sollten Sie das gewünschte Zeitformat mit dem Befehl set festlegen.

Digitale Videogeräte unterstützen zwei Suchmodi, die Sie mit dem Befehl set ändern können. Der Modus "Suche genau ein" bewirkt, dass der seek-Befehl in den angegebenen Frame verschoben wird. Der Modus "Seek exactly off" bewirkt, dass der such-Befehl in den nächstgelegenen Keyframe vor dem angegebenen Frame verschoben wird.

Wenn ein CD-Audiogerät wiedergegeben wird, wenn der Suchbefehl ausgegeben wird, wird die Wiedergabe beendet. Wenn der Suchbefehl mit einem videodisc-Gerät ausgegeben wird, sucht das Gerät mithilfe von schnellem Vorwärts- oder schnellem Reverse mit Video und Audio aus.

Wenn der Suchbefehl mit einem Waveform-Audiogerät ausgegeben wird, hängt das Verhalten von der Stichprobengröße ab. Wenn die Stichprobengröße 16 Bit oder größer ist, wird seek an den Anfang der nächsten Stichprobe verschoben, wenn eine angegebene Position nicht mit dem Start einer Stichprobe übereinstimmt.

Beispiele

Mit dem folgenden Befehl wird bis zum Anfang der Mediendatei gesucht, die dem Gerät "mysound" zugeordnet ist.

seek mysound to start

Requirements (Anforderungen)

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

Weitere Informationen

MCI

MCI-Befehlszeichenfolgen

Hinweis

mark

set