MCI _ SAVE-Befehl

Der Befehl MCI _ SAVE speichert die aktuelle Datei. Geräte, die Dateien ändern, sollten die ursprüngliche Kopie erst zerstören, wenn sie die Speichernachricht erhalten. Videoüberlagerungs- und Waveform-Audiogeräte erkennen diesen Befehl. Obwohl digital-video-Geräte und GIGABYTE-Sequencer diesen Befehl ebenfalls erkennen, implementieren die MCIAVI- und MCISEQ-Treiber ihn nicht.

Rufen Sie zum Senden dieses Befehls die mciSendCommand-Funktion mit den folgenden Parametern auf.

MCIERROR mciSendCommand(
  MCIDEVICEID wDeviceID, 
  MCI_SAVE, 
  DWORD dwFlags, 
  (DWORD) (LPMCI_SAVE_PARMS ) lpSave
);

Parameter

wDeviceID

Gerätebezeichner des MCI-Geräts, das die Befehlsmeldung empfangen soll.

Dwflags

MCI _ NOTIFY, MCI _ WAIT oder, für Digital Video- und VCR-Geräte, MCI _ TEST. Informationen zu diesen Flags finden Sie unter Die Warte-, Benachrichtigungs- und Testflags.

lpSave

Zeiger auf eine MCI _ SAVE _ PARMS-Struktur. (Geräte mit zusätzlichen Parametern können diese Struktur durch eine gerätespezifische Struktur ersetzen.)

Rückgabewert

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

Bemerkungen

Dieser Befehl wird von Geräten unterstützt, die TRUE zurückgeben, wenn Sie den MCI _ GETDEVCAPS-Befehl mit dem _ MCI GETDEVCAPS _ CAN _ SAVE-Flag aufrufen.

Das folgende zusätzliche Flag gilt für alle Geräte, die MCI _ SAVE unterstützen:

_MCI- DATEI SPEICHERN _

Der lpfilename-Member der von lpSave identifizierten Struktur enthält eine Adresse eines Puffers, der den Zieldateinamen enthält.

Die folgenden zusätzlichen Flags werden mit dem Gerätetyp digitalvideo verwendet:

MCI _ DGV _ RECT

Der rc-Member der von lpSave identifizierten Struktur enthält ein gültiges Rechteck. Das Rechteck gibt einen Bereich des Rahmenpuffers an, der in der angegebenen Datei gespeichert wird. Das erste Koordinatenpaar gibt die obere linke Ecke des Rechtecks an. Das zweite Paar gibt die Breite und Höhe an. Digitale Videogeräte müssen den MCI _ CAPTURE-Befehl verwenden, um den Inhalt des Framepuffers zu erfassen. (Videoüberlagerungsgeräte sollten auch MCI _ verwenden. CAPTURE.) Dieses Flag dient zur Kompatibilität mit dem vorhandenen MCI-Videoüberlagerungsbefehlssatz.

MCI _ DGV _ SAVE _ ABORT

Beendet einen ausgeführten Speichervorgang. Dies muss das einzige flag vorhanden sein.

MCI _ DGV _ SAVE _ KEEPRESERVE

Nicht verwendeter Speicherplatz, der vom ursprünglichen MCI _ RESERVE-Befehl übrig bleibt, wird nicht freigegeben.

Bei Digitalvideogeräten verweist der lpSave-Parameter auf eine MCI _ DGV _ SAVE _ PARMS-Struktur.

Das folgende zusätzliche Flag wird mit dem Überlagerungsgerätetyp verwendet:

MCI _ OVLY _ RECT

Der rc-Member der von lpSave identifizierten Struktur enthält ein gültiges Anzeigerechteck, das den Bereich des zu speichernden Videopuffers angibt.

Bei Videoüberlagerungsgeräten zeigt der lpSave-Parameter auf eine MCI _ OVLY _ SAVE _ 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
Mmsystem.h (include Windows.h)

Weitere Informationen

MCI

MCI-Befehle