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 |
|