Freeze-Befehl

Artikel
06/13/2023

Der Freeze-Befehl friert die Videoeingabe oder -ausgabe auf einem Videorekorder ein oder deaktiviert die Videoaufnahme im 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 parameter lpszCommand 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 eingefroren werden soll. In der folgenden Tabelle sind Gerätetypen aufgeführt, die den Freeze-Befehl und die von jedem Typ verwendeten Flags erkennen.

Wert	Bedeutung	Bedeutung
digitalvideo	am Rechteck	Außerhalb
overlay	am Rechteck
Vcr	Feld frame	input output

In der folgenden Tabelle sind die Flags aufgeführt, die im lpszFreezeFlags-Parameter angegeben werden können, und ihre Bedeutungen.

Wert	Bedeutung
am Rechteck	Gibt die Region an, die eingefroren wird. Für Video-Overlay-Geräte ist die Videoerfassung in dieser Region deaktiviert. Bei Digitalvideogeräten ist für die Pixel innerhalb des Rechtecks das Sperrmaskenbit aktiviert (es sei denn, das Flag "außen" 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 an, und die Koordinaten X2 Y2 geben die Breite und Höhe an.
Feld	Friert das erste Feld ein. 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 Eingabeimages ein, unabhängig davon, ob er angehalten oder ausgeführt wird.
output	Friert den aktuellen Frame der Ausgabe aus dem VcR ein. Wenn der VcR beim Einfrieren wiedergegeben wird, wird der aktuelle Frame eingefroren, und der VcR wird angehalten. Wenn der Videorekorder angehalten wird, wenn dieser Befehl ausgegeben wird, wird der aktuelle Frame eingefroren. Das eingefrorene Bild verbleibt auf dem Ausgabegerät, bis ein Befehl zum Aufheben des Einfrierens ausgegeben wird. Wenn weder "input" noch "output" angegeben ist, wird "output" angenommen.
Außerhalb	Gibt an, dass der Bereich außerhalb der region, die mit dem Flag "at" angegeben wurde, eingefroren ist.

lpszFlags

Kann "warten", "benachrichtigen" oder beides sein. Für Digitalvideo- und Videorekordergeräte kann auch "Test" angegeben werden. Weitere Informationen zu diesen Flags finden Sie unter Warte-, Benachrichtigungs- und Testflags.

Rückgabewert

Gibt null zurück, wenn der Vorgang erfolgreich war oder andernfalls ein Fehler.

Bemerkungen

Bei Verwendung mit VcR-Geräten ist dieser Befehl für Framegrabkarten vorgesehen.

Verwenden Sie eine Reihe von Befehlen zum Einfrieren und Aufheben des Einfrierens , um unregelmäßige Erfassungsregionen mit dem Flag "at" anzugeben. Einige Videoüberlagerungsgeräte schränken die Komplexität der Erfassungsregion ein.

Dieser Befehl wird nur unterstützt, wenn ein Aufruf des Funktionsbefehls mit dem Flag "kann einfrieren" TRUE zurückgibt.

Beispiele

Der folgende Befehl deaktiviert die Videoaufnahme in einem 100-Pixel-Quadrat 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

Freigeben über