Befehl "speichern"

Artikel
06/13/2023

Mit dem Befehl speichern wird eine MCI-Datei gespeichert. Video-Overlay- und Waveform-Audiogeräte erkennen diesen Befehl. Obwohl Digital-Video-Geräte und MIDI-Sequenzer diesen Befehl ebenfalls erkennen, unterstützen ihn die MCIAVI- und MCISEQ-Treiber nicht.

Um diesen Befehl zu senden, rufen Sie die mciSendString-Funktion auf, wobei der parameter lpszCommand wie folgt festgelegt ist.

_stprintf_s(
  lpszCommand, 
  TEXT("save %s %s %s"), 
  lpszDeviceID, 
  lpszFilename, 
  lpszFlags
);

Parameter

lpszDeviceID

Bezeichner eines MCI-Geräts. Dieser Bezeichner oder Alias wird zugewiesen, wenn das Gerät geöffnet wird.

lpszFilename

Flag, das den Namen der zu speichernden Datei und optional zusätzliche Flags angibt, die den Speichervorgang ändern. In der folgenden Tabelle sind Gerätetypen aufgeführt, die den Save-Befehl und die von jedem Typ verwendeten Flags erkennen.

Wert	Bedeutung	Bedeutung
digitalvideo	Abbruch am Rechteck	dateinamekeepreserve
overlay	am Rechteck	filename
sequencer	filename
Waveaudio	filename

In der folgenden Tabelle sind die Flags aufgeführt, die im lpszFilename-Parameter angegeben werden können, und ihre Bedeutungen.

Wert	Bedeutung
abort	Beendet einen laufenden Speichervorgang . Wenn verwendet, muss dies das einzige element sein, das vorhanden ist.
am Rechteck	Gibt ein Rechteck relativ zum Framepufferursprung an. Das Rechteck wird als X1 Y1 X2 Y2 angegeben. Die Koordinaten X1 Y1 geben die obere linke Ecke an, und die Koordinaten X2 Y2 geben die Breite und Höhe an. Bei Digitalvideogeräten wird der Capture-Befehl verwendet, um den Inhalt des Framepuffers zu erfassen.
filename	Gibt den Dateinamen an, der der Datendatei zugewiesen werden soll. Wenn kein Pfad angegeben wird, wird die Datei auf dem Datenträger und in dem Verzeichnis abgelegt, das zuvor für den Befehl explizite oder implizite Reserve angegeben wurde. Wenn die Reserve nicht ausgestellt wurde, sind das Standardlaufwerk und das Standardverzeichnis diejenigen, die der Aufgabe der Anwendung zugeordnet sind. Wenn ein Pfad angegeben wird, muss sich das Gerät möglicherweise auf dem Datenträgerlaufwerk befinden, das durch die explizite oder implizite Reserve angegeben ist. Dieses Flag ist erforderlich.
keepreserve	Gibt an, dass nicht genutzter Speicherplatz, der vom ursprünglichen Reservebefehl übrig geblieben ist, nicht zugeordnet wird.

lpszFlags

Kann "warten", "benachrichtigen" oder beides sein. Für Digitalvideo- und Videorekordergeräte kann auch "Test" angegeben werden. Weitere Informationen zu diesen Flags finden Sie unter Warte-, Benachrichtigungs- und Testflags.

Rückgabewert

Gibt null zurück, wenn der Vorgang erfolgreich war oder andernfalls ein Fehler.

Bemerkungen

Die Dateinamenvariable ist erforderlich, wenn das Gerät mit dem "neuen" Gerätebezeichner geöffnet wurde.

Beispiele

Mit dem folgenden Befehl wird der gesamte Videopuffer in einer Datei namens VCAPFILE gespeichert. TGA.

save vboard c:\vcap\vcapfile.tga

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]

Siehe auch

MCI
MCI-Befehlszeichenfolgen
Erfassen
Reservieren