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 |
|