MCI _ DELETE-Befehl
Der Befehl MCI _ DELETE entfernt Daten aus der Datei. Digital-Video- 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_DELETE,
DWORD dwFlags,
(DWORD) (LPMCI_GENERIC_PARMS) lpDelete
);
Parameter
-
wDeviceID
-
Gerätebezeichner des MCI-Geräts, das die Befehlsnachricht empfangen soll.
-
Dwflags
-
MCI _ NOTIFY, MCI _ WAIT oder für Digitalvideogeräte MCI _ TEST. Informationen zu diesen Flags finden Sie unter Die Warte-, Benachrichtigungs- und Testflags.
-
lpDelete
-
Zeiger auf eine MCI _ GENERIC _ 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
Die folgenden Flags gelten für den Gerätetyp digitalvideo:
-
MCI _ DGV _ DELETE _ AT
-
Ein Rechteck ist im rc-Member der -Struktur enthalten, die durch lpDelete identifiziert wird. Das Rechteck gibt den Teil jedes zu löschenden Frames an. Wenn dieses Flag verwendet wird, wird der Frame im Arbeitsbereich beibehalten, und der durch das Rechteck angegebene Bereich wird schwarz. Wenn das Flag weggelassen wird, verwendet MCI DELETE standardmäßig den gesamten Frame und entfernt den _ Frame aus dem Arbeitsbereich.
-
MCI _ DGV _ DELETE _ AUDIO _ STREAM
-
Eine Audiodatenstromnummer ist im dwAudioStream-Member der struktur enthalten, die durch lpDelete identifiziert wird. Wenn Sie dieses Flag verwenden und auch Videos löschen möchten, müssen Sie auch das MCI _ DGV _ DELETE VIDEO _ _ STREAM-Flag verwenden. (Wenn kein Flag angegeben ist, werden Daten aus allen Audio- und Videostreams gelöscht.)
-
MCI _ DGV _ DELETE _ VIDEO _ STREAM
-
Eine Videostreamnummer ist im dwVideoStream-Member der struktur enthalten, die durch lpDelete identifiziert wird. Wenn Sie dieses Flag verwenden und auch Audiodaten löschen möchten, müssen Sie auch das MCI _ DGV _ DELETE AUDIO _ _ STREAM-Flag verwenden. (Wenn kein Flag angegeben ist, werden Daten aus allen Audio- und Videostreams gelöscht.)
-
MCI _ FROM
-
Eine Startposition ist im dwFrom-Member der struktur enthalten, die durch lpDelete identifiziert wird. Die einheiten, die den Positionswerten zugewiesen sind, werden mit dem MCI _ SET TIME FORMAT-Flag des _ _ MCI _ SET-Befehls angegeben.
-
MCI _ TO
-
Eine Endposition ist im dwTo-Member der struktur enthalten, die durch lpDelete identifiziert wird. Die den Positionswerten zugewiesenen Einheiten werden mit dem MCI _ SET _ TIME _ FORMAT-Flag von MCI _ SET angegeben.
Bei Digitalvideogeräten verweist der lpDelete-Parameter auf eine MCI _ DGV DELETE _ _ PARMS-Struktur.
Die folgenden Flags gelten für den Waveaudio-Gerätetyp:
-
MCI _ FROM
-
Eine Startposition ist im dwFrom-Member der struktur enthalten, die durch lpDelete identifiziert wird. Die den Positionswerten zugewiesenen Einheiten werden mit dem MCI _ SET _ TIME FORMAT-Flag von _ MCI SET _ angegeben.
-
MCI _ TO
-
Eine Endposition ist im dwTo-Member der struktur enthalten, die durch lpDelete identifiziert wird. Die den Positionswerten zugewiesenen Einheiten werden mit dem MCI _ SET _ TIME _ FORMAT-Flag von MCI _ SET angegeben.
Bei Waveform-Audiogeräten verweist der lpDelete-Parameter auf eine MCI _ WAVE DELETE _ _ PARMS-Struktur.
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 |
|