befehl MCI_CAPTURE

Der Befehl MCI_CAPTURE erfasst den Inhalt des Framepuffers und speichert ihn in einer angegebenen Datei. Digital-Video-Geräte erkennen diesen Befehl.

Um diesen Befehl zu senden, rufen Sie 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äte-ID des MCI-Geräts, das die Befehlsnachricht 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 .

Gibt null zurück, wenn erfolgreich oder andernfalls ein Fehler auftritt.

Die folgenden zusätzlichen Flags gelten für Digital-Video-Geräte:

MCI_DGV_CAPTURE_AS: Der lpstrFileName-Member der durch lpCapture identifizierten Struktur enthält eine Adresse eines Puffers, die den Zielpfad und dateinamen angibt. (Dieses Flag ist erforderlich.)
MCI_DGV_CAPTURE_AT: Das rc-Element der durch lpCapture identifizierten Struktur enthält ein gültiges Rechteck. Das Rechteck gibt den rechteckigen Bereich innerhalb des Framepuffers an, der zugeschnitten und auf dem Datenträger gespeichert wird. Wenn diese Angabe ausgelassen wird, entspricht der zugeschnittene Bereich standardmäßig dem Rechteck, das in einem vorherigen MCI_PUT Befehl angegeben oder standardmäßig angegeben wurde, der den Quellbereich für diese instance des Gerätetreibers angibt.

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 (windows.h einschließen)