setvideo-Befehl

Der Befehl setvideo legt Werte fest, die der Videowiedergabe und -aufnahme zugeordnet sind. Digitalvideo- und Videorekordergerä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("setvideo %s %s %s"), 
  lpszDeviceID, 
  lpszVideo, 
  lpszFlags
); 

Parameter

lpszDeviceID

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

lpszVideo

Flag für Videowiedergabe und -aufnahme. In der folgenden Tabelle sind Gerätetypen aufgeführt, die den Befehl setvideo und die von jedem Typ verwendeten Flags erkennen.

Wert	Bedeutung	Bedeutung
digitalvideo	Algorithmus-Bitsperpel, um Helligkeit zu faktorclocktimecolor zu zählen, um den Kontrast zum FaktorGamma zu werthalftoneinputkey color zu r:g:bkey index to indexoffonoutput	Über DauerPalette Farbfarbe über Indexzu newrgb Palettenhandle zum Behandeln derQualitätsdeskriptorDatensatz Bildrate zur Ratedatensatz onrecord offsharpness to factorsource to source number valuestill Algorithmusnoch Qualität DescriptorStream to NumberTint to Factor
Vcr	offonmonitor zum Eingeben vonNummerndatensatzoffrecord track track_number off	Record onrecord Track track_number onsource zum Eingeben von Nummernnummern track track_number offtrack track_number on

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

Wert	Bedeutung
Algorithmus	Gibt einen Videokomprimierungsalgorithmus zur Verwendung durch einen nachfolgenden Reserve- oder Datensatzbefehl an. Von einem Gerät unterstützte Algorithmen sind gerätespezifisch. MCI definiert die Konstanten "mpeg" und "h261" für den Algorithmus. Wenn der angegebene Algorithmus mit dem aktuellen Dateiformat in Konflikt steht, wird das Dateiformat in das Standardformat für den Algorithmus geändert.
bitsperpel to count	Legt die Anzahl der Bits pro Pixel zum Speichern von Daten mit dem Befehl capture oder record fest.
Helligkeit zu Faktor	Legt die Videohelligkeit fest.
clocktime	Gibt an, dass die im Flag "over" angegebene Zeit in Millisekunden liegt. Die Zeit ist absolut und entspricht nicht der Wiedergabe des Arbeitsbereichs.
Farbe zu Faktor	Legt die Farbsättigungsstufe fest.
Kontrast zum Faktor	Legt die Videokontraststufe fest.
Gamma zu Wert	Gibt den Gammakorrektur-Exponenten multipliziert mit 1000 an. Verwenden Sie beispielsweise 2200 als Wert, um einen Exponenten von 2.2 anzugeben. Ein Gammawert von 1,0 (1000) gibt an, dass keine Gammakorrektur angewendet wird. Die Gammakorrektur passt die Zuordnung zwischen der in der Präsentationsquelle codierten Intensität und der angezeigten Helligkeit an.
Halbton	Bewirkt, dass die Halbtonpalette anstelle der Standardpalette verwendet wird. Dieses Flag wird nur vom MCIAVI-Digitalvideotreiber erkannt.
input	Ändert das Flag "Helligkeit", "Farbe", "Kontrast", "Gamma", "Schärfe" oder "Farbton", sodass es das Eingabesignal beeinflusst und die Aufgezeichneten ändert. Wenn möglich, ist dies die Standardeinstellung bei der Überwachung der Eingabe.
Schlüsselfarbe für r:g:b	Legt die Schlüsselfarbe fest. Die Variable r:g:b ist ein RGB-Wert. Doppelpunkte (:) trennen Sie die einzelnen roten, grünen und blauen Werte.
Schlüsselindex für Index	Legt den Schlüsselindex fest. Die Indexvariable ist ein physischer Palettenindex.
überwachen, um die Nummer einzugeben	Steuert, welche Quelleingabe an die VCR-Ausgabe übergeben wird, ohne die Auswahl der Aufzeichnungsquelle zu ändern. Der Typ kann "ausgabe" oder eine der gültigen Eingabequellen sein. Wenn "Zahl" nicht angegeben wird, wird die erste Eingabe dieses Typs ausgewählt.
offon	Aktiviert oder deaktiviert die Anzeige von Videos. Durch das Deaktivieren des Videos werden die Pixel im "Ziel"-Rechteck (oder dessen Standardbereich, der Clientbereich des aktuellen Fensters) auf eine Volltonfarbe festgelegt. Es hat keine Auswirkungen auf den Framepuffer. Die Videoquelle, unabhängig davon, ob es sich um den Arbeitsbereich oder eine externe Eingabe handelt, speichert möglicherweise weiterhin neue Bilder im Framepuffer. Sie werden erst angezeigt, wenn das Video aktiviert ist. Sie können den Befehl "status" des Fensters verwenden, um das Fenster auszublenden. Der Standardwert ist festgelegtvideo "on".
output	Ändert das Flag "Helligkeit", "Farbe", "Kontrast", "Gamma", "Schärfe" oder "Farbton", sodass es nur das angezeigte Signal und nicht das aufgezeichnete Signal ändert. Wenn möglich, ist dies die Standardeinstellung bei der Überwachung einer Datei.
Dauer	Gibt an, wie lange es dauern soll, eine Änderung vorzunehmen, die eine Faktorvariable verwendet. Die Einheiten für die Dauer befinden sich im aktuellen Zeitformat. Änderungen erfolgen im Schritt mit der Wiedergabe des Arbeitsbereichs. Wenn das Spielen angehalten wird, wird auch die Änderung angehalten, bis das Spiel fortgesetzt wird. Wenn "over" nicht verwendet oder nicht unterstützt wird, erfolgt die Änderung sofort.
Farbpalettenfarbe über Index zu newrgb	Legt eine neue Palettenfarbe fest. Der zu ändernde Farb- und Palettenindex wird durch die Farb- und Indexparameter angegeben. die neue Farbe wird von newrgb angegeben. Dieses Flag wird nur vom MCIAVI-Digitalvideotreiber erkannt.
Zu behandelnde Palettenhandle	Gibt das Handle für eine Palette an, die das Gerät zum Rendern verwenden muss. Dieses Element wird nur von Geräten unterstützt, die Paletten verwenden. Wenn handle null ist, wird die Standardpalette verwendet. Digital-Videogeräte sollten die Palette, die mit diesem Befehl übergeben wurde, nicht freigeben. Anwendungen sollten es nach dem Schließen des Geräts freigeben.
Qualitätsdeskriptor	Gibt die Merkmale der Videokomprimierung an, die beim Aufzeichnen von Videos in einer Datei ausgeführt wird. Alle Geräte unterstützen die drei Deskriptoren "low", "medium" und "high". Der Standardwert ist gerätespezifisch. Die Bedeutung dieser Namen hängt vom Algorithmus und dem Gerät ab. Geräte können zusätzliche Deskriptornamen definieren. Mit dem Qualitätsbefehl können zusätzliche Deskriptornamen definiert werden. Wenn das Flag "Algorithmus" nicht verwendet wird, gilt der Deskriptor für den aktuellen Algorithmus.
Bildrate auf -Rate aufzeichnen	Legt die Aufzeichnung für Das Bewegungsvideo fest. Die Aufzeichnungsrate wird in Einheiten von Frames pro Sekunde multipliziert mit 1000 angegeben. Beispielsweise wird die NTSC-Bildrate von 29,97 Frames pro Sekunde als 29970 dargestellt.
Datensatz onrecord off	Aktiviert oder deaktiviert die Aufzeichnung von Videodaten. Die Aufzeichnung von Videodaten ist die Standardeinstellung.
Record Track track_number off	Löscht die Auswahl der Videoquelle, sodass mit dem Befehl zum nächsten Datensatz kein Video aufgezeichnet wird. "Track" ermöglicht die unabhängige Titelauswahl. Wenn "track" nicht angegeben ist, wird der Standardwert 1 angenommen. Es kann erforderlich sein, zuerst einen set-Befehl "Datensatz aus zusammenstellen" auszugeben, bevor die Videoaufzeichnung deaktiviert werden kann.
Track track_number auf aufzeichnen	Wählt die Videoquelle aus, die mit dem Befehl " Nächster Datensatz" aufgezeichnet werden soll. "Track" ermöglicht die unabhängige Titelauswahl. Track 2 entspricht dem PCM-Track in Hi8. Wenn "Track" nicht angegeben ist, wird der Standardwert 1 angenommen.
Schärfe zum Faktor	Legt die Schärfestufe des Videos fest.
Source-to-Source-Nummer-Wert	Legt die Quelle der Videoeingabe fest. Dies entspricht in der Regel externen Connectors. Die für die Quelle definierten Konstanten umfassen "rgb", "pal", "ntsc", "svideo" und "secam". Wenn mehrere Eingaben des angegebenen Typs vorhanden sind, gibt der optionale Wert "number" die gewünschte Eingabe an. Beispielsweise gibt setvideo "source to ntsc number 2" die zweite NTSC-Eingabe an. Wenn "to" -Quelle ausgelassen wird, wird die absolute Quelle verwendet, wie im Befehl "Videoquelle" der Liste definiert.
Quelle zum Eingeben derZahlnummer	Wählt die Videoquelle aus, die auf dem Band aufgezeichnet werden soll. Der Typ muss "tuner", "line", "svideo", "aux", "generic", "mute" oder "rgb" sein.
Still-Algorithmus	Gibt den Algorithmus zur Komprimierung von Standbildern an, der vom Capture-Befehl verwendet wird. Jedes Gerät muss einen Algorithmus von "none" unterstützen, d. h. keine Komprimierung. Dies ist die Standardeinstellung. In diesem Fall speichern Digital-Videogeräte Standbilder als geräteunabhängige RGB-Bitmaps. Geräte können auch eine gerätespezifische Liste mit zusätzlichen Algorithmen unterstützen.
noch Qualitätsdeskriptor	Gibt die Merkmale der Stillbildkomprimierung an, die beim Erfassen eines Standbilds ausgeführt wird. Alle Geräte unterstützen die Deskriptoren "niedrig", "mittel" und "hoch". Der Standardwert ist gerätespezifisch. Wenn das Flag "Algorithmus" nicht verwendet wird, gilt der Deskriptor für den aktuellen Algorithmus. Der Qualitätsbefehl kann verwendet werden, um andere Deskriptornamen zu definieren.
stream to number	Gibt den Videostream an, der aus dem Arbeitsbereich wiedergegeben wird. Wenn der Stream nicht angegeben ist und kein Standarddatenstrom durch das Dateiformat definiert ist, wird der physisch erste verschachtelte Videodatenstrom wiedergegeben.
Farbton zu Faktor	Legt den Farbton des Bilds fest. In der Regel wird diese Anpassung nach der Farbsteuerung vieler Farbfernsehgeräte modelliert, wobei 250 die Bedeutung grün, 750 rot und 0 (oder)

lpszFlags

Kann "warten", "benachrichtigen", "testen" oder eine Kombination aus diesen sein. 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 VcR-Geräten kann die Verwendung von setvideo mit einem Flag, das eine einzelne Spur ausschaltet ("Track track_number off") dazu führen, dass Ihre Anwendung eine status Meldung empfängt, die angibt, dass der Befehl nicht ausgeführt werden konnte. Einige VCRs können nur Kombinationen von Spuren, nicht einzelne Spuren deaktivieren. beispielsweise die erste Audiospur und eine Videospur einer Videokassette. In diesem Fall verwenden Sie einfach setaudio und setvideo, um die anderen Spuren, aus denen die Kombination besteht, weiterhin zu deaktivieren. Der Fahrer schaltet die Gleise ab, wenn er den Befehl erhält, die letzte Strecke in der Kombination zu deaktivieren.

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

Erfassen

list

put

record

Reservieren

set

Setaudio

Fenster