Put-Befehl

Der Befehl put definiert den Bereich des Quellbilds und des Zielfensters, das für die Anzeige verwendet wird. Digital-Video- und Video-Overlay-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("put %s %s %s"), 
  lpszDeviceID, 
  lpszRegions, 
  lpszFlags
); 

Parameter

lpszDeviceID

Bezeichner eines MCI-Geräts. Dieser Bezeichner oder Alias wird zugewiesen, wenn das Gerät geöffnet wird.

lpszRegions

Flag zum Definieren des Bereichs. In der folgenden Tabelle sind Gerätetypen aufgeführt, die den Put-Befehl und die von den einzelnen Typen verwendeten Flags erkennen.

Wert	Bedeutung	Bedeutung
digitalvideo	Zielziel am Rechteckrahmenam Rechteckquellquelleam Rechteck	Videovideo im Rechteckfensterfensterim RechteckfensterClientfensterclient am Rechteck
overlay	Zielziel am Rechteckrahmenrahmenam Rechteck	Quellquelle bei Rechteckvideovideoam Rechteck

In der folgenden Tabelle sind die Flags aufgeführt, die im lpszRegions-Parameter angegeben werden können, und deren Bedeutung.

Wert	Bedeutung
destination	Wählt den gesamten Clientbereich des Zielfensters aus, um die Daten anzuzeigen.
Ziel am Rechteck	Wählt einen Teil des Clientbereichs des Zielfensters aus, das zum Anzeigen des Bilds verwendet wird. Wenn ein Bereich des Anzeigefensters angegeben wird und das Gerät das Strecken unterstützt, wird das Quellbild auf den Zieloffset und die Zielausdehnung gestreckt.
frame	Wählt den gesamten Framepuffer aus, um die eingehenden Videobilder zu empfangen.
Rahmen am Rechteck	Wählt einen Teil des Framepuffers aus, um die eingehenden Videobilder zu empfangen.
source	Wählt das gesamte Bild aus, das im Zielfenster angezeigt werden soll.
Quelle am Rechteck	Wählt einen Teil des Bilds aus, der im Zielfenster angezeigt werden soll. Wenn ein Bereich des Quellbilds angegeben wird und das Gerät das Strecken unterstützt, wird das Quellbild bis zum Zieloffset und -ausdehnung gestreckt.
video	Wählt das gesamte eingehende Videobild aus, das im Framepuffer erfasst werden soll.
Video am Rechteck	Wählt einen Teil des eingehenden Videobilds aus, das im Framepuffer erfasst werden soll.
Fenster	Stellt die anfängliche Fenstergröße auf der Anzeige wieder her. Mit diesem Befehl wird auch das Fenster angezeigt.
Fenster im Rechteck	Ändert die Größe und Position des Anzeigefensters. Das angegebene Rechteck ist relativ zum übergeordneten Fenster des Anzeigefensters (in der Regel der Desktop), wenn das Flag "untergeordnete Formatvorlage" für den Open-Befehl verwendet wurde. Um die Position des Fensters zu ändern, ohne seine Höhe oder Breite zu ändern, geben Sie null für die Höhe und Breite an.
Window-Client	Stellt den Clientbereich des Fensters wieder her.
Fensterclient am Rechteck	Ändert die Größe und Position des Clientbereichs des Fensters. Das angegebene Rechteck ist relativ zum übergeordneten Fenster des Clientfensters. Um die Position des Fensters zu ändern, ohne seine Höhe oder Breite zu ändern, geben Sie null für die Höhe und Breite an.

Wenn ein Flag ein Rechteck enthält, sind die Rechteckkoordinaten relativ zum Fensterursprung oder Bildursprung, je nach Bedarf, und sie werden als X1 Y1 X2 Y2 angegeben. Die Koordinaten X1Y1 geben die obere linke Ecke an, und die Koordinaten X2Y2 geben die Breite und Höhe des Rechtecks an.

lpszFlags

Kann "warte", "benachrichtigen" oder beides sein. Für Digital-Video-Geräte kann auch "Test" angegeben werden. Weitere Informationen zu diesen Flags finden Sie unter Die Warte-, Benachrichtigungs- und Testflags.

Rückgabewert

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

Bemerkungen

Der Befehl put definiert eines oder mehrere der folgenden Rechtecke bei der Arbeit mit Videoüberlagerungsgeräten:

• Das Videorechteck definiert den Bereich des eingehenden Videobilds, das erfasst werden soll.
• Das Framerechteck definiert den Bereich des Framepuffers, der das eingehende Videobild empfängt.
• Das Quellrechteck definiert, welcher Bereich des Framepuffers in das Zielrechteck kopiert wird.
• Das Zielrechteck definiert den Bereich des Clientbereichs des Anzeigefensters, der das Videobild empfängt.

Das Videorechteck bezieht sich auf das Framerechteck auf die gleiche Weise wie das Quellrechteck auf das Zielrechteck. Die Dehnung kann vom Videorechteck zum Framerechteck und vom Quellrechteck zum Zielrechteck erfolgen. Nicht alle Geräte unterstützen Das Dehnen, und Das Dehnen muss aktiviert werden (mithilfe des Befehls set ).

Der folgende Befehl definiert drei Regionen für das Video, den Frame und die Quelle.

put vboard video 120 120 200 200 frame 0 0 200 200 source 0 0 200 200

Die Regionen in diesem Beispiel sind wie folgt definiert:

• Ein Bereich von 200 x 200 Pixeln der eingehenden Videodaten, beginnend bei einem Ursprung von 120 Pixeln von der oberen linken Ecke, wird im Framepuffer erfasst.
• Die Videodaten werden in einem Bereich von 200 x 200 Pixeln in der oberen linken Ecke des Framepuffers platziert.
• Übertragungen werden vom 200 x 200 Pixel-Bereich in der oberen linken Ecke des Framepuffers zum Zielfenster durchgeführt.

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

open

set