Record-Befehl

Der Befehl record beginnt mit der Aufzeichnung von Daten. VCR- und Waveform-Audiogeräte erkennen diesen Befehl. Obwohl digital-video-Geräte und DANN-Sequencer diesen Befehl ebenfalls erkennen, implementieren die MCIAVI- und MCISEQ-Treiber ihn nicht.

Um diesen Befehl zu senden, rufen Sie die mciSendString-Funktion mit dem lpszCommand-Parameter auf, der 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 für das 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 am Rechteck-Audiodatenstrom von Position halten Einfügen von Overwrite zum Positionieren des Videostreamstreams
sequencer aus Position einfügen An Position überschreiben
Vcr at time from position initialize An Position überschreiben einfügen
Waveaudio aus Position einfügen An Position überschreiben

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

Wert Bedeutung
am 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 das Rechteck standardmäßig auf das Rechteck festgelegt, das für put "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 mit einem Cuing-Befehl begonnen wurde, wenn der Cued-Befehl beginnt. Weitere Informationen finden Sie im Cue-Befehl.
Audiostreamstream Gibt den Audiostream an, der für die Aufzeichnung verwendet wird. Wenn dieses Flag nicht angegeben ist und das Dateiformat keinen Standardwert definiert, wird es in dem Stream aufgezeichnet, der physisch zuerst ist.
von Position Gibt eine Anfangsposition 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 zu zeigen. Wenn die Aufzeichnung beendet wird, wird ein automatischer "Datei"-Befehl für die Überwachung ausgeführt. Um zum Livevideo zurückzukehren, geben Sie den Befehl "eingabe" des Monitors aus.
initialisieren Initialisieren Sie das Band (Medien), das die Aufzeichnung des Zeitcodes (sofern möglich) für leeres Video und Audio umfasst. 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.
nach Position Gibt eine Endposition für die Aufzeichnung an. Wenn das To-Flag nicht angegeben ist, zeichnet das Gerät auf, bis es einen Stopp- oder Pause-Befehl empfängt.
Videostreamstream Gibt den Videostream an, der für die Aufzeichnung verwendet wird. Wenn dies nicht angegeben ist und das Dateiformat keinen Standardwert definiert, wird es in dem Stream aufgezeichnet, der physisch zuerst verwendet wird.

lpszFlags

Kann "wait", "notify" 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 0 (null) zurück, wenn erfolgreich, andernfalls ein Fehler.

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.

Vor dem Ausführen von Befehlen, die Positionswerte verwenden, sollten Sie das gewünschte Zeitformat mit dem Set-Befehl festlegen. Die zu notierenden Spuren werden mit den Befehlen settimecode "record", set "assemble record", setvideo "record" und setaudio "record" angegeben.

Beispiele

Mit dem folgenden Befehl wird die Aufzeichnung an der aktuellen Position gestartet.

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