befehl MCI_RECORD
Der MCI_RECORD-Befehl startet die 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 MIDI-Sequenzer diesen Befehl ebenfalls erkennen, implementieren ihn die Treiber MCIAVI und MCISEQ nicht.
Um diesen Befehl zu senden, rufen Sie 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 Befehlsnachricht empfangen soll.
-
dwFlags
-
MCI_NOTIFY, MCI_WAIT oder für Digitalvideo- und Videorekordergeräte MCI_TEST. Informationen zu diesen Flags finden Sie unter 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 null zurück, wenn der Vorgang erfolgreich war oder andernfalls ein Fehler.
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_RECORD 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
-
Ein Startort ist im dwFrom-Element der durch lpRecord identifizierten Struktur enthalten. Die den Positionswerten zugewiesenen Einheiten werden mit dem MCI_SET_TIME_FORMAT Flag des befehls MCI_SET angegeben. Wenn MCI_FROM nicht angegeben ist, wird der Startort 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. Falls unterstützt, ist dies die Standardeinstellung.
-
MCI_RECORD_OVERWRITE
-
Daten sollten vorhandene Daten überschreiben. Die MCIWAVE. Das DRV-Gerät gibt als Reaktion auf dieses Flag MCIERR_UNSUPPORTED_FUNCTION zurück.
-
MCI_TO
-
Ein Endspeicherort ist im dwTo-Element der durch lpRecord identifizierten Struktur enthalten. Die den Positionswerten zugewiesenen Einheiten werden mit dem MCI_SET_TIME_FORMAT Flag des befehls MCI_SET 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, enthält der Bildschirm das letzte Bild und wird erst dann fortgesetzt, wenn ein MCI_MONITOR-Befehl ausgegeben wird.
-
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
-
Im rc-Member der durch lpRecord identifizierten Struktur wird ein Rechteck angegeben. Das Rechteck gibt den Bereich der externen Eingabe an, die als Quelle für die komprimierten und gespeicherten Pixel verwendet wird. Dieses Rechteck wird standardmäßig auf das Rechteck festgelegt, das vom MCI_DGV_PUT_VIDEO Flag für den Befehl MCI_PUT angegeben (oder standardmäßig festgelegt ist). Wenn es anders als das Videorechteck festgelegt ist, wird nicht das Aufgezeichnete angezeigt.
Bei Digitalvideogeräten verweist lpRecord auf eine MCI_DGV_RECORD_PARMS Struktur.
Die folgenden zusätzlichen Flags werden mit dem Vcr-Gerätetyp verwendet:
-
MCI_VCR_RECORD_AT
-
Das dwAt-Element der durch lpRecord identifizierten Struktur enthält einen Zeitpunkt, zu dem der gesamte Befehl beginnt, oder wenn das Gerät eine Cued-Instanz erhält, wenn das Gerät die vom Befehl cue angegebene Position erreicht.
-
MCI_VCR_RECORD_INITIALIZE
-
Suchen Sie das Gerät bis zum Start der Medien, beginnen Sie mit der Aufzeichnung von leerem Video und Audio, und zeichnen Sie nach Möglichkeit den Timecode auf.
Bei VCR-Geräten verweist 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 |
|