Record-Befehl

Der Befehl record startet die Aufzeichnung von Daten. VcR- 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 mciSendString-Funktion auf, wobei der parameter lpszCommand wie folgt festgelegt ist.

_stprintf_s(
  lpszCommand, 
  TEXT("record %s %s %s"), 
  lpszDeviceID, 
  lpszRecordFlags, 
  lpszFlags
); 

Parameter

lpszDeviceID

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

lpszRecordFlags

Flag zum Aufzeichnen von Daten. In der folgenden Tabelle sind Gerätetypen aufgeführt, die den Datensatzbefehl und die von den einzelnen Typen verwendeten Flags erkennen.

Wert	Bedeutung	Bedeutung
digitalvideo	bei Rechteckaudio stream streamfrom positionhold	Einfügen des Überschreibens zum Positionierendes Videostreams
sequencer	aus Positioneinfügen	Überschreiben an Position
Vcr	zum Zeitpunktder Initialisierung von der Position	Insert overwrite to position
Waveaudio	aus Positioneinfügen	Überschreiben an Position

In der folgenden Tabelle sind die Flags aufgeführt, die im lpszRecordFlags-Parameter angegeben werden können, und deren Bedeutung.

Wert	Bedeutung
im Rechteck	Gibt einen rechteckigen Bereich der externen Eingabe an, der als Quelle für die komprimierten und gespeicherten Pixel verwendet wird. Wenn nicht angegeben, wird für das Rechteck standardmäßig das rechteck verwendet, das für " video" angegeben ist. Wenn es anders als das Rechteck "Video" festgelegt ist, ist das angezeigte Bild nicht das, was aufgezeichnet wird.
zur Zeit	Gibt an, wann das Gerät mit der Ausführung dieses Befehls beginnen soll, oder, wenn das Gerät übergeben wurde, wenn der cued-Befehl beginnt. Weitere Informationen finden Sie im Cue-Befehl .
Audiostreamstream	Gibt den für die Aufzeichnung verwendeten Audiodatenstrom an. Wenn dieses Flag nicht angegeben ist und das Dateiformat keine Standardeinstellung definiert, wird es in den Datenstrom aufgezeichnet, der zuerst physisch ist.
von Position	Gibt eine Startposition für die Aufzeichnung an. Wenn das Flag "from" nicht angegeben ist, beginnt das Gerät mit der Aufzeichnung an der aktuellen Position.
Halten	Friert das Bild ein, wenn die Aufzeichnung abgeschlossen ist, anstatt Livevideos anzuzeigen. Wenn die Aufzeichnung beendet wird, wird ein automatischer Monitorbefehl "datei" ausgeführt. Um zum Livevideo zurückzukehren, geben Sie den Monitorbefehl "eingabe" aus.
initialisieren	Initialisieren Sie das Band (Medium), wobei der Timecode (falls möglich) für leere Videos und Audiodaten aufgezeichnet wird. Dieser Befehl kann mehrere Stunden dauern, wenn das gesamte Band initialisiert werden muss.
insert	Gibt an, dass der Datei an der aktuellen Position neue Daten hinzugefügt werden.
overwrite	Gibt an, dass neue Daten daten in der Datei ersetzen.
zu positionieren	Gibt eine Endposition für die Aufzeichnung an. Wenn das Flag "an" nicht angegeben ist, zeichnet das Gerät auf, bis es einen Befehl zum Beenden oder Anhalten empfängt.
Videostreamstream	Gibt den videostream an, der für die Aufzeichnung verwendet wird. Wenn dies nicht angegeben ist und das Dateiformat keine Standardeinstellung definiert, wird es in den Datenstrom aufgezeichnet, der zuerst physisch ist.

lpszFlags

Kann "warte", "benachrichtigen" oder beides sein. Für Digital-Video- und VcR-Geräte kann auch "Test" angegeben werden. Weitere Informationen zu diesen Flags finden Sie unter Die Warte-, Benachrichtigungs- und Testflags.

Rückgabewert

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

Bemerkungen

Die Aufzeichnung wird beendet, wenn ein Befehl zum Beenden oder Anhalten ausgegeben wird. Für den MCIWAVE-Treiber werden alle Nach dem Öffnen einer Datei aufgezeichneten Daten verworfen, wenn die Datei geschlossen wird, ohne sie zu speichern.

Bevor Sie Befehle ausgeben, die Positionswerte verwenden, sollten Sie das gewünschte Zeitformat mit dem Befehl set festlegen. Die aufzuzeichnenden Titel werden durch die Befehle settimecode "record", set "assemble record", setvideo "record" und setaudio "record" angegeben.

Beispiele

Der folgende Befehl startet die Aufzeichnung an der aktuellen Position.

record mysound

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

Hinweis

Monitor

pause

Put

set

Setaudio

settimecode

setvideo

stop