Seek-Befehl

Artikel
06/13/2023

Der Seek-Befehl wird an die angegebene Position verschoben und beendet. CD-Audio-, Digital-Video-, MIDI-Sequencer-, VCR-, Videodisc- 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("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 zum Verschieben an eine angegebene Position. In der folgenden Tabelle sind Gerätetypen aufgeführt, die den Seek-Befehl und die von den einzelnen Typen verwendeten Flags erkennen.

Wert	Bedeutung	Bedeutung
cdaudio	an End-to-Position	zum Starten
digitalvideo	an End-to-Position	zum Starten
sequencer	an End-to-Position	zum Starten
Vcr	bei Zeitmarkemark_numumgekehrt	end-to-positionto start
videodisc	reverse to end	, umzu starten
Waveaudio	an End-to-Position	zum Starten

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

Wert	Bedeutung
zur Zeit	Gibt an, wann das Gerät mit der Ausführung dieses Befehls beginnen soll, oder, wenn das Gerät übergeben wurde, wenn der cued-Befehl beginnt. Weitere Informationen finden Sie im Cue-Befehl .
mark_num markieren	Sucht nach der durch mark_num angegebenen relativen Markierung, die ein positiver ganzzahliger Wert sein muss. Markierungen sind Signale, die mit dem Befehl mark auf das Videorekorderband geschrieben werden und für die Suche mit hoher Geschwindigkeit verwendet werden.
reverse	Gibt an, dass die Suchrichtung auf Videorekordern 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.
bis zum Ende	Sucht bis zum Ende des Inhalts.
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.
zum Starten	Sucht am Anfang des Inhalts.

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

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

Digital-Video-Geräte unterstützen zwei Suchmodi, die Sie mit dem Befehl set ändern können. Der Modus "genau aufsuchen" bewirkt, dass der Seek-Befehl zum angegebenen Frame wechselt. Der Modus "Genau aus suchen" bewirkt, dass der Seek-Befehl zum nächstgelegenen Keyframe vor dem angegebenen Frame wechselt.

Wenn ein CD-Audiogerät wiedergegeben wird, wenn der Seek-Befehl ausgegeben wird, wird die Wiedergabe beendet. Wenn der Seek-Befehl mit einem videodisc-Gerät ausgegeben wird, sucht das Gerät mit schnellem Vorwärts oder schnellem Rückwärtsgang, wobei Video und Audio deaktiviert sind.

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

Beispiele

Der folgende Befehl sucht zum Start der Mediendatei, die dem Gerät "mysound" zugeordnet ist.

seek mysound to start

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
Hinweis
mark
set

Freigeben über