befehl MCI_SEEK

Der Befehl MCI_SEEK ändert die aktuelle Position im Inhalt so schnell wie möglich. Die Video- und Audioausgabe sind während der Suche deaktiviert. Nachdem die Suche abgeschlossen ist, wird das Gerät beendet. CD-Audio-, Digital-Video-, MIDI-Sequencer-, VCR-, Videodisc- und Waveform-Audiogerä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äte-ID des MCI-Geräts, das die Befehlsnachricht empfangen soll.

dwFlags

MCI_NOTIFY, MCI_WAIT oder MCI_TEST für digitale Video- und Videorekordergeräte. 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 können diese Struktur durch eine gerätespezifische Struktur ersetzen.)

Rückgabewert

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

Bemerkungen

Wenn eine Datenbeispielgröße für ein Gerät größer als 1 Byte ist (z. B. bei Waveform-Audio-Stereodaten), wird dieser Befehl an den Anfang der nächsten Stichprobe verschoben, wenn eine angegebene Position nicht mit dem Anfang einer Stichprobe übereinstimmt.

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-Element der durch lpSeek identifizierten Struktur enthalten. Die den Positionswerten zugewiesenen Einheiten werden mit dem MCI_SET_TIME_FORMAT-Flag des befehls MCI_SET 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 von lpSeek identifizierten Struktur enthält einen Zeitpunkt, zu dem der gesamte Befehl beginnt.

MCI_VCR_SEEK_MARK

Das dwMark-Element der von lpSeek identifizierten Struktur enthält die nummerierte Markierung, nach der gesucht werden soll.

MCI_VCR_SEEK_REVERSE

Die Suchrichtung ist umgekehrt; dies wird nur mit dem flag MCI_VCR_SEEK_MARK 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.

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 (windows.h einschließen)

Siehe auch

MCI

MCI-Befehle