Freigeben über


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
Mmsystem.h (einschließlich Windows.h)

Siehe auch

MCI

MCI-Befehle