befehl MCI_DELETE

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äte-ID des MCI-Geräts, das die Befehlsnachricht empfangen soll.

dwFlags

MCI_NOTIFY, MCI_WAIT oder bei Digital-Video-Geräten 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 können diese Struktur durch eine gerätespezifische Struktur ersetzen.)

Rückgabewert

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

Bemerkungen

Die folgenden Flags gelten für den Digitalvideo-Gerätetyp :

MCI_DGV_DELETE_AT

Ein Rechteck ist im rc-Element der durch lpDelete identifizierten Struktur enthalten. 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 ausgelassen wird, wird MCI_DELETE standardmäßig auf den gesamten Frame festgelegt und der Frame wird aus dem Arbeitsbereich entfernt.

MCI_DGV_DELETE_AUDIO_STREAM

Eine Audiodatenstromnummer ist im dwAudioStream-Element der durch lpDelete identifizierten Struktur enthalten. Wenn Sie dieses Flag verwenden und auch Videos löschen möchten, müssen Sie auch das flag MCI_DGV_DELETE_VIDEO_STREAM verwenden. (Wenn keines der Flags angegeben ist, werden Daten aus allen Audio- und Videodatenströmen gelöscht.)

MCI_DGV_DELETE_VIDEO_STREAM

Eine Videostreamnummer ist im dwVideoStream-Element der durch lpDelete identifizierten Struktur enthalten. Wenn Sie dieses Flag verwenden und auch Audiodaten löschen möchten, müssen Sie auch das flag MCI_DGV_DELETE_AUDIO_STREAM verwenden. (Wenn keines der Flags angegeben ist, werden Daten aus allen Audio- und Videodatenströmen gelöscht.)

MCI_FROM

Eine Startposition ist im dwFrom-Element der struktur enthalten, die durch lpDelete identifiziert wird. Die den Positionswerten zugewiesenen Einheiten werden mit dem MCI_SET_TIME_FORMAT-Flag des befehls MCI_SET angegeben.

MCI_TO

Im dwTo-Element der durch lpDelete identifizierten Struktur ist eine Endposition enthalten. Die den Positionswerten zugewiesenen Einheiten werden mit dem MCI_SET_TIME_FORMAT Flag von MCI_SET angegeben.

Bei Digital-Video-Geräten verweist der parameter lpDelete auf eine MCI_DGV_DELETE_PARMS-Struktur .

Die folgenden Flags gelten für den Waveaudio-Gerätetyp :

MCI_FROM

Eine Startposition ist im dwFrom-Element 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

Im dwTo-Element der durch lpDelete identifizierten Struktur ist eine Endposition enthalten. Die den Positionswerten zugewiesenen Einheiten werden mit dem MCI_SET_TIME_FORMAT Flag von MCI_SET angegeben.

Bei Waveform-Audio-Geräten verweist der parameter lpDelete auf eine MCI_WAVE_DELETE_PARMS-Struktur .

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