Freeze-Befehl
Der Befehl freeze friert video input or video output on a VCR (Videoeingabe oder Videoausgabe auf einem VCR) ein oder deaktiviert die Videoerfassung für den Framepuffer. Digital-Video-, Video-Overlay- und VCR-Geräte erkennen diesen Befehl.
Um diesen Befehl zu senden, rufen Sie die mciSendString-Funktion auf, wobei der lpszCommand-Parameter wie folgt festgelegt ist.
_stprintf_s(
lpszCommand,
TEXT("freeze %s %s %s"),
lpszDeviceID,
lpszFreezeFlags,
lpszFlags
);
Parameter
-
lpszDeviceID
-
Bezeichner eines MCI-Geräts. Dieser Bezeichner oder Alias wird zugewiesen, wenn das Gerät geöffnet wird.
-
lpszFreezeFlags
-
Flag, das angibt, was fixiert werden soll. Die folgende Tabelle enthält Gerätetypen, die den Freeze-Befehl und die von den einzelnen Typen verwendeten Flags erkennen.
Wert Bedeutung Bedeutung digitalvideo am Rechteck Außerhalb overlay am Rechteck Vcr - Feld
- frame
- input
- output
Die folgende Tabelle enthält die Flags, die im lpszFreezeFlags-Parameter angegeben werden können, und ihre Bedeutungen.
Wert Bedeutung am Rechteck Gibt den Bereich an, der eingefroren wird. Für Videoüberlagerungsgeräte ist die Videoerfassung in dieser Region deaktiviert. Bei Digitalvideogeräten ist das Sperrmaskenbit in den Pixeln innerhalb des Rechtecks aktiviert (es sei denn, das Flag "outside" ist angegeben). Das Rechteck ist relativ zum Ursprung des Videopuffers und wird als X1 Y1 X2 Y2 angegeben. Die Koordinaten X1 Y1 geben die obere linke Ecke des Rechtecks und die Koordinaten X2 Y2 die Breite und Höhe an. Feld Friert das erste Feld ein. Das Feld wird standardmäßig angenommen (wenn weder Frame noch Feld angegeben ist). frame Friert den gesamten Frame ein und zeigt beide Felder an. input Friert den aktuellen Frame des Eingabebilds ein, unabhängig davon, ob es angehalten ist oder ausgeführt wird. output Friert den aktuellen Frame der Ausgabe des VCR ein. Wenn der VCR beim Einfrieren wiedergegeben wird, wird der aktuelle Frame fixiert, und der VCR wird angehalten. Wenn der VCR angehalten wird, wenn dieser Befehl ausgegeben wird, wird der aktuelle Frame fixiert. Das fixierte Bild verbleibt auf dem Ausgabegerät, bis ein Befehl zum Aufheben der Freigabe ausgegeben wird. Wenn weder "input" noch "output" angegeben ist, wird "output" angenommen. Außerhalb Gibt an, dass der Bereich außerhalb des mit dem Flag "at" angegebenen Bereichs fixiert ist. -
lpszFlags
-
Kann "wait", "notify" oder beides sein. Für DigitalVideo- und VCR-Geräte kann auch "Test" angegeben werden. Weitere Informationen zu diesen Flags finden Sie unter Die Warte-, Benachrichtigungs- und Testflags.
Rückgabewert
Gibt 0 (null) zurück, wenn der Fehler erfolgreich war, oder andernfalls ein Fehler.
Bemerkungen
Bei Verwendung mit VCR-Geräten ist dieser Befehl für Frame-Grabb-Karten vorgesehen.
Um unregelmäßige Erfassungsregionen mit dem Flag "at" anzugeben, verwenden Sie eine Reihe von Befehlen zum Einfrieren und Aufheben der Fixierung. Einige Videoüberlagerungsgeräte beschränken die Komplexität der Kaufregion.
Dieser Befehl wird nur unterstützt, wenn ein Aufruf des Funktionsbefehls mit dem Flag "can freeze" TRUE zurückgibt.
Beispiele
Der folgende Befehl deaktiviert die Videoerfassung in einem Quadrat mit 100 Pixeln in der oberen linken Ecke des Videopuffers.
freeze vboard at 0 0 100 100
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) |
Windows 2000 Professional [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) |
Windows 2000 Server [nur Desktop-Apps] |