MCI _ CAPTURE-Befehl

Der MCI _ CAPTURE-Befehl erfasst den Inhalt des Framepuffers und speichert ihn in einer angegebenen Datei. Digitalvideogeräte erkennen diesen Befehl.

Rufen Sie zum Senden dieses Befehls die mciSendCommand-Funktion mit den folgenden Parametern auf.

MCIERROR mciSendCommand(
  MCIDEVICEID wDeviceID, 
  MCI_CAPTURE, 
  DWORD dwFlags, 
  (DWORD) (LPMCI_DGV_CAPTURE_PARMS) lpCapture
);

Parameter

wDeviceID

Gerätebezeichner des MCI-Geräts, das die Befehlsmeldung empfangen soll.

Dwflags

MCI _ NOTIFY, MCI _ WAIT oder MCI _ TEST. Informationen zu diesen Flags finden Sie unter Die Warte-, Benachrichtigungs- und Testflags.

lpCapture

Zeiger auf eine MCI _ DGV _ CAPTURE _ PARMS-Struktur.

Rückgabewert

Gibt 0 (null) zurück, wenn erfolgreich, andernfalls ein Fehler.

Bemerkungen

Die folgenden zusätzlichen Flags gelten für Digitalvideogeräte:

MCI _ DGV _ CAPTURE _ AS

Der lpstrFileName-Member der von lpCapture identifizierten Struktur enthält eine Adresse eines Puffers, der den Zielpfad und den Dateinamen angibt. (Dieses Flag ist erforderlich.)

MCI _ DGV _ CAPTURE _ AT

Der rc-Member der von lpCapture identifizierten Struktur enthält ein gültiges Rechteck. Das Rechteck gibt den rechteckigen Bereich innerhalb des Rahmenpuffers an, der zugeschnitten und auf dem Datenträger gespeichert wird. Wenn diese Option nicht angegeben wird, wird der zugeschnittene Bereich standardmäßig auf das Rechteck festgelegt oder standardmäßig auf einem vorherigen MCI _ PUT-Befehl festgelegt, der den Quellbereich für diese Instanz des Gerätetreibers angibt.

Requirements (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 (include Windows.h)

Weitere Informationen

MCI

MCI-Befehle