Capture-Befehl
Der Capture-Befehl kopiert den Inhalt des Framepuffers und speichert ihn in der angegebenen Datei. Digital-Videogeräte erkennen diesen Befehl.
Um diesen Befehl zu senden, rufen Sie die mciSendString-Funktion auf, wobei der parameter lpszCommand wie folgt festgelegt ist.
_stprintf_s(
lpszCommand,
TEXT("capture %s %s %s"),
lpszDeviceID,
lpszCapture,
lpszFlags
);
-
lpszDeviceID
-
Bezeichner eines MCI-Geräts. Dieser Bezeichner oder Alias wird zugewiesen, wenn das Gerät geöffnet wird.
-
lpszCapture
-
Mindestens eins der folgenden Flags:
Wert Bedeutung als Pfadname Gibt den Zielpfad und dateinamen für das erfasste Image an. Dieses Flag ist erforderlich. am Rechteck Gibt den rechteckigen Bereich innerhalb des Framepuffers an, den das Gerät zuschneidet und auf dem Datenträger speichert. Wenn er nicht angegeben wird, wird für den zuschneidenden Bereich standardmäßig das Rechteck verwendet, das bei einem vorherigen Befehl "source" für dieses Gerät instance angegeben oder standardmäßig angegeben wurde. -
lpszFlags
-
Kann "warten", "benachrichtigen", "testen" oder eine Kombination aus diesen sein. Weitere Informationen zu diesen Flags finden Sie unter Warte-, Benachrichtigungs- und Testflags.
Gibt null zurück, wenn der Vorgang erfolgreich war oder andernfalls ein Fehler.
Dieser Befehl schlägt möglicherweise fehl, wenn das Gerät derzeit Bewegungsvideos abspielt oder einen anderen ressourcenintensiven Vorgang ausführt. Wenn der Framepuffer in Echtzeit aktualisiert wird, wird die Aktualisierung vorübergehend angehalten, sodass ein vollständiges Bild erfasst wird. Wenn das Gerät die Aktualisierung anhält, kann es zu einem visuellen oder akustischen Effekt kommen. Wenn das Dateiformat, der Komprimierungsalgorithmus und die Qualitätsebenen nicht festgelegt wurden, werden ihre Standardwerte verwendet.
Anforderung | Wert |
---|---|
Unterstützte Mindestversion (Client) |
Windows 2000 Professional [nur Desktop-Apps] |
Unterstützte Mindestversion (Server) |
Windows 2000 Server [nur Desktop-Apps] |