befehl MCI_SAVE

Der Befehl MCI_SAVE speichert die aktuelle Datei. Geräte, die Dateien ändern, sollten die originale Kopie erst zerstören, wenn sie die Speichernachricht erhalten. Video-Overlay- und Waveform-Audiogeräte erkennen diesen Befehl. Digital-Video-Geräte und MIDI-Sequencer erkennen diesen Befehl zwar ebenfalls, aber die Treiber MCIAVI und MCISEQ implementieren ihn nicht.

Um diesen Befehl zu senden, rufen Sie die mciSendCommand-Funktion mit den folgenden Parametern auf.

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

Parameter

wDeviceID

Geräte-ID des MCI-Geräts, das die Befehlsnachricht empfangen soll.

dwFlags

MCI_NOTIFY, MCI_WAIT oder MCI_TEST für digitale Video- und Videorekordergeräte. 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 null zurück, wenn erfolgreich oder andernfalls ein Fehler auftritt.

Bemerkungen

Dieser Befehl wird von Geräten unterstützt, die TRUE zurückgeben, wenn Sie den Befehl MCI_GETDEVCAPS mit dem flag MCI_GETDEVCAPS_CAN_SAVE aufrufen.

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

MCI_SAVE_FILE

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 Digitalvideo-Gerätetyp verwendet:

MCI_DGV_RECT

Der rc-Member der von lpSave identifizierten Struktur enthält ein gültiges Rechteck. Das Rechteck gibt einen Bereich des Framepuffers 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. Digital-Video-Geräte müssen den Befehl MCI_CAPTURE verwenden, um den Inhalt des Framepuffers zu erfassen. (Videoüberlagerungsgeräte sollten auch MCI_CAPTURE verwenden.) Dieses Flag dient der Kompatibilität mit dem vorhandenen MCI-Befehlssatz für Videoüberlagerungen.

MCI_DGV_SAVE_ABORT

Beendet einen laufenden Speichervorgang. Dies muss das einzige flag sein, das vorhanden ist.

MCI_DGV_SAVE_KEEPRESERVE

Nicht verwendeter Speicherplatz, der vom ursprünglichen MCI_RESERVE Befehl übrig bleibt , wird nicht aufgehoben.

Bei Digitalvideogeräten verweist der parameter lpSave auf eine MCI_DGV_SAVE_PARMS-Struktur .

Das folgende zusätzliche Flag wird mit dem Overlay-Gerätetyp verwendet:

MCI_OVLY_RECT

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

Bei Videoüberlagerungsgeräten verweist der lpSave-Parameter auf eine MCI_OVLY_SAVE_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