Befehl "cut"

Der Ausschneidebefehl entfernt Daten aus dem Arbeitsbereich und kopiert sie in die Zwischenablage. Digitalvideogeräte erkennen diesen Befehl.

Um diesen Befehl zu senden, rufen Sie die mciSendString-Funktion mit dem lpszCommand-Parameter auf, der wie folgt festgelegt ist.

_stprintf_s(
  lpszCommand, 
  TEXT("cut %s %s %s"), 
  lpszDeviceID, 
  lpszItem, 
  lpszFlags
); 

Parameter

lpszDeviceID

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

lpszItem

Eines der folgenden Flags, das das ausschneidende Element identifiziert.

Wert Bedeutung
am Rechteck Gibt den Teil der einzelnen Rahmenschnitte an. Wenn sie nicht angegeben 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 in dem Arbeitsbereich an, der vom Befehl betroffen ist. Wenn Sie dieses Flag verwenden und auch Video ausschneiden möchten, müssen Sie auch das Flag "Videostream" verwenden. (Wenn kein Flag angegeben ist, werden alle Audio- und Videostreams ausgeschnitten.)
von Position Gibt den Anfang des Bereichsschnitts an. Wenn sie nicht angegeben wird, wird standardmäßig die aktuelle Position verwendet.
nach Position Gibt das Ende des Bereichsschnitts an. Der Ausschneiden von Audio- und Videodaten ist von dieser Position aus nicht möglich. Wenn sie nicht angegeben wird, wird standardmäßig das Ende des Arbeitsbereichs verwendet.
Videostreamstream Gibt den Videostream in dem Arbeitsbereich an, der vom Befehl betroffen ist. Wenn Sie dieses Flag verwenden und auch Audio ausschneiden möchten, müssen Sie auch das Flag "Audiostream" verwenden. (Wenn kein Flag angegeben ist, werden alle Audio- und Videostreams ausgeschnitten.)

lpszFlags

Kann "wait", "notify", "test" oder eine Kombination aus diesen sein. Weitere Informationen zu diesen Flags finden Sie unter Die Warte-, Benachrichtigungs- und Testflags.

Rückgabewert

Gibt 0 (null) zurück, wenn erfolgreich, andernfalls ein Fehler.

Bemerkungen

Die Änderung wird nur dauerhaft, wenn die Daten explizit gespeichert werden. Die Wiedergabe verhält sich jedoch so, als ob die Daten entfernt wurden.

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