MCI _ SEEK-Befehl
Der MCI _ SEEK-Befehl ändert die aktuelle Position im Inhalt so schnell wie möglich. Die Video- und Audioausgabe wird während der Suche deaktiviert. Nachdem die Suche abgeschlossen ist, wird das Gerät beendet. CD-Audio- und Digitalvideogeräte, DIE SEQUENCEr-, VCR-, videodisc- und waveform-audio-Geräte erkennen diesen Befehl.
Um diesen Befehl zu senden, rufen Sie die mciSendCommand-Funktion mit den folgenden Parametern auf.
MCIERROR mciSendCommand(
MCIDEVICEID wDeviceID,
MCI_SEEK,
DWORD dwFlags,
(DWORD) (LPMCI_SEEK_PARMS) lpSeek
);
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.
-
lpSeek
-
Zeiger auf eine MCI _ SEEK _ 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
Wenn eine Datenstichprobengröße für ein Gerät größer als 1 Byte ist (z. B. bei Waveform-Audio-Stereodaten), wechselt dieser Befehl an den Anfang der nächsten Stichprobe, wenn eine angegebene Position nicht mit dem Start einer Stichprobe zusammentrifft.
Die folgenden zusätzlichen Flags gelten für alle Geräte, die MCI _ SEEK unterstützen:
-
MCI _ SEEK _ TO _ END
-
Suchen Sie bis zum Ende des Inhalts.
-
MCI _ SEEK _ TO _ START
-
Suchen Sie bis zum Anfang des Inhalts.
-
MCI _ TO
-
Eine Position ist im dwTo-Member der -Struktur enthalten, die durch lpSeek identifiziert wird. Die einheiten, die den Positionswerten zugewiesen sind, werden mit dem MCI _ SET TIME FORMAT-Flag des _ _ MCI _ SET-Befehls angegeben. Verwenden Sie dieses Flag nicht mit MCI _ SEEK TO END oder _ _ MCI SEEK TO _ _ _ START.
Die folgenden zusätzlichen Flags werden mit dem vcr-Gerätetyp verwendet:
-
MCI _ VCR _ SEEK _ AT
-
Der dwAt-Member der durch lpSeek identifizierten Struktur enthält einen Zeitpunkt, zu dem der gesamte Befehl beginnt.
-
MCI _ VCR _ SEEK _ MARK
-
Der dwMark-Member der durch lpSeek identifizierten Struktur enthält die nummerierte Markierung, nach der gesucht werden soll.
-
MCI _ VCR _ SEEK _ REVERSE
-
Die Suchrichtung ist umgekehrt. wird nur mit dem MCI _ VCR _ SEEK _ MARK-Flag verwendet.
Bei VCR-Geräten verweist der lpSeek-Parameter auf eine MCI _ VCR _ SEEK _ PARMS-Struktur.
Das folgende zusätzliche Flag wird mit dem Videodisc-Gerätetyp verwendet:
-
MCI _ VD _ SEEK _ REVERSE
-
Die Suchrichtung ist umgekehrt.
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 |
|