delete command

  • Artikel

Der Befehl delete löscht ein Datensegment aus einer Datei. Digital-Video- 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("delete %s %s %s"), 
  lpszDeviceID, 
  lpszPosition, 
  lpszFlags
);

Parameter

lpszDeviceID

Bezeichner eines MCI-Geräts. Dieser Bezeichner oder Alias wird zugewiesen, wenn das Gerät geöffnet wird.

lpszPosition

Flag, das ein zu löschende Datensegment identifiziert. In der folgenden Tabelle sind Gerätetypen aufgeführt, die den Befehl delete und die von jedem Typ verwendeten Flags erkennen.

Wert Bedeutung Bedeutung
digitalvideo
  • am Rechteck
  • Audiostreamstream
  • von Position
  • zu positionieren
  • Videostreamstream
Waveaudio von Position zu positionieren

In der folgenden Tabelle sind die Flags aufgeführt, die im lpszPosition-Parameter angegeben werden können, und ihre Bedeutungen.

Wert Bedeutung
am Rechteck Gibt den Teil jedes gelöschten Frames an. Wenn er ausgelassen wird, wird standardmäßig der gesamte Frame verwendet. Wenn dieses Element angegeben wird, werden Frames nicht gelöscht. Stattdessen wird der Bereich innerhalb des Rechtecks schwarz.
Audiostreamstream Gibt den Audiostream im Arbeitsbereich an, der vom Befehl betroffen ist. Wenn Sie dieses Flag verwenden und auch Videos löschen möchten, müssen Sie auch das Flag "Videostream" verwenden. (Wenn keines der Flags angegeben ist, werden alle Audio- und Videodatenströme gelöscht.)
von Position Gibt die Position an, an der das Löschen beginnt. Wenn dieses Flag weggelassen wird, beginnt der Löschvorgang an der aktuellen Position.
zu positionieren Gibt die Position an, an der der Löschvorgang endet. Wenn dieses Flag weggelassen wird, wird der Löschvorgang bis zum Ende des Inhalts oder Arbeitsbereichs fortgesetzt.
Videostreamstream Gibt den Videostream im Arbeitsbereich an, der vom Befehl betroffen ist. Wenn Sie dieses Flag verwenden und auch Audiodaten löschen möchten, müssen Sie auch das Flag "Audiostream" verwenden. (Wenn keines der Flags angegeben ist, werden alle Audio- und Videodatenströme gelöscht.)

lpszFlags

Kann "warten", "benachrichtigen" oder beides sein. Für Digitalvideo- und Videorekordergeräte kann auch "Test" angegeben werden. Weitere Informationen zu diesen Flags finden Sie unter Warte-, Benachrichtigungs- und Testflags.

Rückgabewert

Gibt null zurück, wenn der Vorgang erfolgreich war oder andernfalls ein Fehler.

Bemerkungen

Bevor Sie Befehle ausgeben, die Positionswerte verwenden, sollten Sie das gewünschte Zeitformat mithilfe des Befehls set festlegen.

Beispiele

Der folgende Befehl löscht die Waveform-Audiodaten von 1 Millisekunde bis 900 Millisekunden (vorausgesetzt, das Zeitformat ist auf Millisekunden festgelegt).

delete mysound from 1 to 900

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

set