Freigeben über


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 .

Rückgabewert

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

Bemerkungen

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.

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

Weitere Informationen

MCI

MCI-Befehle