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
Mmsystem.h (include Windows.h)

Weitere Informationen

MCI

MCI-Befehle