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]

Siehe auch

MCI

MCI-Befehlszeichenfolgen

capability

Auftauen