MCI _ RECORD-Befehl
Der MCI _ RECORD-Befehl beginnt mit der Aufzeichnung von der aktuellen Position oder von einem angegebenen Speicherort an einem anderen angegebenen Speicherort. VCR- und Waveform-Audiogeräte erkennen diesen Befehl. Obwohl digital-video-Geräte und GIGABYTE-Sequencer diesen Befehl ebenfalls erkennen, implementieren die MCIAVI- und MCISEQ-Treiber ihn nicht.
Rufen Sie zum Senden dieses Befehls die mciSendCommand-Funktion mit den folgenden Parametern auf.
MCIERROR mciSendCommand(
MCIDEVICEID wDeviceID,
MCI_RECORD,
DWORD dwFlags,
(DWORD) (LPMCI_RECORD_PARMS) lpRecord
);
Parameter
-
wDeviceID
-
Gerätebezeichner des MCI-Geräts, das die Befehlsmeldung empfangen soll.
-
Dwflags
-
MCI _ NOTIFY, MCI _ WAIT oder für Digital Video- und VCR-Geräte, MCI _ TEST. Informationen zu diesen Flags finden Sie unter Die Warte-, Benachrichtigungs- und Testflags.
-
lpRecord
-
Zeiger auf eine MCI _ RECORD _ PARMS-Struktur. (Geräte mit erweiterten Befehlssätzen können diese Struktur durch eine gerätespezifische Struktur ersetzen.)
Rückgabewert
Gibt 0 (null) zurück, wenn der Fehler erfolgreich war, oder andernfalls ein Fehler.
Bemerkungen
Dieser Befehl wird von Geräten unterstützt, die TRUE zurückgeben, wenn Sie den MCI _ GETDEVCAPS-Befehl mit dem _ MCI GETDEVCAPS _ CAN _ RECORD-Flag aufrufen. Für den MCIWAVE-Treiber werden alle Nach dem Öffnen einer Datei aufgezeichneten Daten verworfen, wenn die Datei geschlossen wird, ohne sie zu speichern.
Die folgenden zusätzlichen Flags gelten für alle Geräte, die MCI _ RECORD unterstützen:
-
MCI _ FROM
-
Eine Startposition ist im dwFrom-Member der durch lpRecord identifizierten Struktur enthalten. Die den Positionswerten zugewiesenen Einheiten werden mit dem MCI _ SET _ TIME _ FORMAT-Flag des MCI _ SET-Befehls angegeben. Wenn MCI _ FROM nicht angegeben ist, wird die Startposition standardmäßig auf die aktuelle Position festgelegt.
-
MCI _ RECORD _ INSERT
-
Neu aufgezeichnete Informationen sollten in die vorhandenen Daten eingefügt oder eingefügt werden. Einige Geräte unterstützen dies möglicherweise nicht. Wenn dies unterstützt wird, ist dies die Standardeinstellung.
-
MCI _ RECORD _ OVERWRITE
-
Daten sollten vorhandene Daten überschreiben. The MCIWAVE. Das DRV-Gerät gibt MCIERR _ UNSUPPORTED _ FUNCTION als Reaktion auf dieses Flag zurück.
-
MCI _ TO
-
Eine Endposition ist im dwTo-Member der durch lpRecord identifizierten Struktur enthalten. Die den Positionswerten zugewiesenen Einheiten werden mit dem MCI _ SET _ TIME _ FORMAT-Flag des MCI _ SET-Befehls angegeben. Wenn MCI _ TO nicht angegeben ist, wird der Endspeicherort standardmäßig auf das Ende des Inhalts festgelegt.
Die folgenden zusätzlichen Flags werden mit dem Gerätetyp digitalvideo verwendet:
-
MCI _ DGV _ RECORD _ AUDIO _ STREAM
-
Eine Audiostreamnummer ist im dwAudioStream-Member der durch lpRecord identifizierten Struktur enthalten. Wenn Sie dieses Flag weglassen, werden Audiodaten im ersten physischen Stream aufgezeichnet.
-
MCI _ DGV _ RECORD _ HOLD
-
Wenn die Aufzeichnung beendet wird, wird das letzte Bild auf dem Bildschirm angezeigt, und das Video wird erst wieder angezeigt, wenn ein MCI _ MONITOR-Befehl ausgegeben wurde.
-
MCI _ DGV _ RECORD _ VIDEO _ STREAM
-
Eine Videostreamnummer ist im dwVideoStream-Member der durch lpRecord identifizierten Struktur enthalten. Wenn Sie dieses Flag weglassen, werden Videodaten im ersten physischen Stream aufgezeichnet.
-
MCI _ DGV _ RECT
-
Ein Rechteck wird im rc-Member der durch lpRecord identifizierten Struktur angegeben. Das Rechteck gibt den Bereich der externen Eingabe an, der als Quelle für die komprimierten und gespeicherten Pixel verwendet wird. Dieses Rechteck wird standardmäßig auf das Rechteck festgelegt (oder standardmäßig festgelegt), das vom MCI _ DGV _ PUT _ VIDEO-Flag für den MCI _ PUT-Befehl angegeben wird. Wenn es anders als das Videorechteck festgelegt ist, wird nicht angezeigt, was aufgezeichnet wird.
Für Digitalvideogeräte zeigt lpRecord auf eine MCI _ DGV _ RECORD _ PARMS-Struktur.
Die folgenden zusätzlichen Flags werden mit dem Vcr-Gerätetyp verwendet:
-
MCI _ VCR _ RECORD _ AT
-
Der dwAt-Member der von lpRecord identifizierten Struktur enthält einen Zeitpunkt, zu dem der gesamte Befehl beginnt, oder , wenn das Gerät angekuppelt wird, wenn das Gerät von der vom Cue-Befehl angegebenen Position erreicht wird.
-
INITIALISIEREN DES _ MCI-VCR-DATENSATZES _ _
-
Suchen Sie das Gerät bis zum Anfang des Mediums, beginnen Sie mit der Aufzeichnung leerer Videos und Audiodaten, und zeichnen Sie nach Möglichkeit den Zeitcode auf.
Für VCR-Geräte zeigt lpRecord auf eine MCI _ VCR _ RECORD _ 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 |
|