befehl MCI_SETVIDEO

Der Befehl MCI_SETVIDEO legt Werte fest, die der Videowiedergabe zugeordnet sind. Digitalvideo- und Videorekordergeräte erkennen diesen Befehl.

Um diesen Befehl zu senden, rufen Sie die mciSendCommand-Funktion mit den folgenden Parametern auf.

MCIERROR mciSendCommand(
  MCIDEVICEID wDeviceID, 
  MCI_SETVIDEO, 
  DWORD dwFlags, 
  (DWORD) (LPMCI_GENERIC_PARMS) lpSetVideo
);

Parameter

wDeviceID

Geräte-ID des MCI-Geräts, das die Befehlsnachricht empfangen soll.

dwFlags

MCI_NOTIFY, MCI_WAIT oder MCI_TEST. Informationen zu diesen Flags finden Sie unter Die Warte-, Benachrichtigungs- und Testflags.

lpSetVideo

Zeiger auf eine MCI_GENERIC_PARMS-Struktur . (Geräte mit erweiterten Befehlssätzen können diese Struktur durch eine gerätespezifische Struktur ersetzen.)

Rückgabewert

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

Bemerkungen

Die folgenden zusätzlichen Flags werden mit dem Gerätetyp "digitalvideo" verwendet:

MCI_DGV_SETVIDEO_ALG

Das lpstrAlgorithm-Element der durch lpSetVideo identifizierten Struktur enthält eine Adresse eines Puffers, der den Namen eines Videokomprimierungsalgorithmus enthält. Der Komprimierungsalgorithmus wird von nachfolgenden MCI_RESERVE - oder MCI_RECORD-Befehlen verwendet. Die verfügbaren Algorithmen sind geräteabhängig.

Wenn der angegebene Algorithmus mit dem aktuellen Dateiformat nicht kompatibel ist, wird das Dateiformat in das Standardformat für den Algorithmus geändert.

MCI_DGV_SETVIDEO_CLOCKTIME

Bei Verwendung mit MCI_DGV_SETVIDEO_OVER gibt an, dass die Zeit in Millisekunden und absolute Zeit angegeben wird. (Dieses Mal wird nicht mit der Wiedergabe des Arbeitsbereichs schrittweise ausgeführt.)

MCI_DGV_SETVIDEO_INPUT

Ändert die MCI_DGV_SETVIDEO_BRIGHTNESS, MCI_DGV_SETVIDEO_COLOR, MCI_DGV_SETVIDEO_CONTRAST, MCI_DGV_SETVIDEO_GAMMA, MCI_DGV_SETVIDEO_SHARPNESS oder MCI_DGV_SETVIDEO_TINT so, dass sie sich auf das Eingabesignal auswirken und die Aufgezeichneten ändern. Wenn möglich, ist dies die Standardeinstellung bei der Überwachung der Eingabe.

MCI_DGV_SETVIDEO_ITEM

Im dwItem-Element der durch lpSetVideo identifizierten Struktur wird eine Videokonstante angegeben. Die Konstante identifiziert den wert, der festgelegt wird. Sie können die folgenden Konstanten mit diesem Flag angeben:

MCI_AVI_SETVIDEO_DRAW_PROCEDURE

Im dwValue-Element der durch lpSetVideo identifizierten Struktur wird eine neue Zeichnungsprozeduradresse angegeben. Sie können eine neue Zeichnungsprozedur nur angeben, wenn sich das Gerät im Leerlauf befindet. Dieses Flag wird nur vom MCIAVI Digital-Video-Treiber erkannt. Es gibt keine Entsprechung zu diesem Flag in der Zeichenfolgenbefehlsschnittstelle.

MCI_AVI_SETVIDEO_PALETTE_COLOR

In den Elementen dwOver und dwValue der durch lpSetVideo identifizierten Struktur wird eine neue Palettenfarbe angegeben. Das dwOver-Element gibt den Palettenindex der zu ändernden Farbe an, und das dwValue-Element gibt die neue Farbe als RGB-Wert an. Sie müssen auch die MCI_DGV_SETVIDEO_OVER und MCI_DGV_SETVIDEO_VALUE Flags mit MCI_DGV_SETVIDEO_ITEM angeben, wenn Sie diese Konstante verwenden. Dieses Flag wird nur vom MCIAVI Digital-Video-Treiber erkannt.

MCI_AVI_SETVIDEO_PALETTE_HALFTONE

Gibt an, dass anstelle der Standardpalette die Halbtonpalette verwendet werden soll. Dieses Flag wird nur vom MCIAVI Digital-Video-Treiber erkannt.

MCI_DGV_SETVIDEO_BITSPERPEL

Die Anzahl der Bits pro Pixel wird im dwValue-Element der durch lpSetVideo identifizierten Struktur angegeben. Die Anzahl der Bits pro Pixel wird zum Speichern von erfassten oder aufgezeichneten Daten verwendet.

MCI_DGV_SETVIDEO_BRIGHTNESS

Die Videohelligkeitsstufe wird als Faktor im dwValue-Element der durch lpSetVideo identifizierten Struktur angegeben.

MCI_DGV_SETVIDEO_COLOR

Die Videofarbsättigungsstufe wird als Faktor im dwValue-Element der durch lpSetVideo identifizierten Struktur angegeben.

MCI_DGV_SETVIDEO_CONTRAST

Die Videokontraststufe wird als Faktor im dwValue-Element der durch lpSetVideo identifizierten Struktur angegeben.

MCI_DGV_SETVIDEO_FRAME_RATE

Eine Bildfrequenz wird im dwValue-Element der durch lpSetVideo identifizierten Struktur angegeben. Die Rate wird in Einheiten von Frames pro Sekunde angegeben, mal 1000. Beispielsweise werden 29,97 Frames pro Sekunde als 29970 angegeben.

MCI_DGV_SETVIDEO_GAMMA

Ein Gammakorrektur-Exponentwert wird im dwValue-Element der durch lpSetVideo identifizierten Struktur angegeben. Die Gammakorrektur passt die Zuordnung zwischen der in der Präsentationsquelle codierten Intensität und der angezeigten Helligkeit an. Der Wert ist der Exponent multipliziert mit 1000. Beispielsweise gibt 2200 einen Exponenten von 2,2 an. Der Wert 1000 gibt einen Exponenten von 1 an, der keine Gammakorrektur anwendet.

MCI_DGV_SETVIDEO_KEY_COLOR

Im dwValue-Element der durch lpSetVideo identifizierten Struktur wird eine Schlüsselfarbe angegeben. Die Schlüsselfarbe ist ein RGB-Wert.

MCI_DGV_SETVIDEO_KEY_INDEX

Ein Schlüsselindexwert wird im dwValue-Element der durch lpSetVideo identifizierten Struktur angegeben. Der Indexparameter ist ein physischer Palettenindex.

MCI_DGV_SETVIDEO_PALHANDLE

Im dwValue-Element der durch lpSetVideo identifizierten Struktur wird ein Palettenhandle angegeben. Das Palettenhandle ist im Wort mit niedriger Reihenfolge enthalten. Digital-Video-Geräte sollten die Palette, die mit diesem Befehl übergeben wird, nicht freigeben. Anwendungen sollten es freigeben, nachdem sie das Gerät geschlossen haben. Dieses Flag wird nur von Geräten unterstützt, die Paletten verwenden. Wenn dieses angegebene Palettenhandle null ist, wird die Standardpalette verwendet.

MCI_DGV_SETVIDEO_SHARPNESS

Ein Videoschärfewert wird als Faktor im dwValue-Element der durch lpSetVideo identifizierten Struktur angegeben.

MCI_DGV_SETVIDEO_SOURCE

Eine Konstante, die die Quelle der Videoeingabe angibt, wird im dwValue-Element der durch lpSetVideo identifizierten Struktur angegeben. Die folgenden Konstanten werden definiert:

• MCI_DGV_SETVIDEO_SRC_NTSC: NTSC-Fernsehen.
• MCI_DGV_SETVIDEO_SRC_PAL: PAL-Fernsehen.
• MCI_DGV_SETVIDEO_SRC_RGB: RGB-Video.
• MCI_DGV_SETVIDEO_SRC_SECAM: SECAM-Fernsehen.
• MCI_DGV_SETVIDEO_SRC_SVIDEO: S-Video.

MCI_DGV_SETVIDEO_STREAM

Ein Videostream wird im dwValue-Element der struktur angegeben, die durch lpSetVideo identifiziert wird. Der ganzzahlige Wert gibt den Videostream an, der aus dem Arbeitsbereich wiedergegeben wird. Wenn der Datenstrom nicht angegeben ist und das Dateiformat keinen Standarddatenstrom definiert, wird der erste physisch überlappene Videodatenstrom wiedergegeben.

MCI_DGV_SETVIDEO_TINT

Ein Videotonwert wird als Faktor im dwValue-Element der durch lpSetVideo identifizierten Struktur angegeben. In der Regel wird diese Anpassung nach der Farbsteuerung vieler Farbfernsehgeräte modelliert, wobei 250 als grün, 750 als Rot und 0 (oder 1000) als Blau definiert sind. Der Nominalwert ist immer 500.

MCI_DGV_SETVIDEO_OUTPUT

Das Flag MCI_DGV_SETVIDEO_BRIGHTNESS, MCI_DGV_SETVIDEO_COLOR, MCI_DGV_SETVIDEO_CONTRAST, MCI_DGV_SETVIDEO_GAMMA, MCI_DGV_SETVIDEO_SHARPNESS oder MCI_DGV_SETVIDEO_TINT wird so geändert, dass es nur das angezeigte Signal und nicht das aufgezeichnete Signal betrifft. Wenn möglich, ist dies die Standardeinstellung bei der Überwachung einer Datei.

MCI_DGV_SETVIDEO_OVER

Ein Parameter für die Übergangslänge ist im dwOver-Element der durch lpSetVideo identifizierten Struktur enthalten. Die Übergangslänge gibt an, wie lange (im aktuellen Zeitformat) es dauern soll, eine Änderung vorzunehmen. Wenn dieses Flag nicht verwendet wird, erfolgt die Änderung sofort.

MCI_DGV_SETVIDEO_QUALITY

Der lpstrQuality-Member der durch lpSetVideo identifizierten Struktur enthält eine Adresse eines Puffers, der die Videoqualität beschreibt. Eine Textzeichenfolge im Puffer gibt die Merkmale des Videokomprimierungsalgorithmus an.

Das flag MCI_DGV_SETVIDEO_ALG kann verwendet werden, um einen Qualitätsdeskriptor für den angegebenen Algorithmus auszuwählen. Wenn dieses Flag weggelassen wird, wird der aktuelle Algorithmus verwendet.

Die verfügbaren Algorithmen und Deskriptornamen hängen vom Gerät ab. Jedes Gerät stellt dokumentation für die verfügbaren Algorithmen und eine Beschreibung der entsprechenden Deskriptornamen bereit. Der Befehl MCI_QUALITY kann zusätzliche Deskriptornamen definieren. Alle Geräte unterstützen die Deskriptoren "low", "medium" und "high". Der Standardwert ist treiberspezifisch.

MCI_DGV_SETVIDEO_RECORD

Gibt an, ob die Aufzeichnung Videodaten einschließt oder ausschließt. In Kombination mit MCI_SET_ON werden Videodaten aufgezeichnet. In Kombination mit MCI_SET_OFF werden Videodaten ausgeschlossen. Die Standardeinstellung umfasst Videodaten.

MCI_DGV_SETVIDEO_SRC_NUMBER

Eine Zahl für die Videoquelle wird im dwSourceNumber-Member der durch lpSetVideo identifizierten Struktur angegeben. Wenn mehrere Eingaben des durch MCI_DGV_SETVIDEO_VALUE angegebenen Typs vorhanden sind, wählt der Wert die Eingabe aus. Dieses Flag muss immer mit MCI_DGV_SETVIDEO_SOURCE verwendet werden. Wenn MCI_DGV_SETVIDEO_VALUE jedoch ausgelassen wird, gibt die angegebene Quellnummer die absolute Quelle an, die wie im befehl MCI_LIST angegeben verwendet werden soll.

MCI_DGV_SETVIDEO_STILL

Der angegebene Algorithmusname oder Qualitätswert gilt für Standbilder.

Jeder Gerätetreiber muss den Algorithmus "none" unterstützen, d. h. keine Komprimierung. Dies ist die Standardeinstellung. In diesem Fall speichern Digital-Video-Geräte Standbilder als RGB-geräteunabhängige Bitmaps (DIBs).

MCI_DGV_SETVIDEO_VALUE

Ein Wert ist im dwValue-Element der struktur enthalten, die durch lpSetVideo identifiziert wird. Die Bedeutung des Werts wird durch das flag MCI_DGV_SETVIDEO_ITEM angegeben.

MCI_SET_OFF

Deaktiviert die Videoausgabe. Bei Digitalvideogeräten wird durch das Deaktivieren von Video die Pixel im Zielrechteck festgelegt, die durch den Befehl MCI_PUT definiert werden (bzw. deren Standard, der Clientbereich des aktuellen Fensters), auf eine Volltonfarbe festgelegt, aber dies hat keine Auswirkungen auf den Framepuffer. Sie können das Fenster bei Bedarf mit dem Befehl MCI_WINDOW ausblenden. Die Videoquelle, ob es sich um den Arbeitsbereich oder eine externe Eingabe handelt, speichert möglicherweise weiterhin neue Bilder im Framepuffer, aber sie werden erst angezeigt, wenn das Video aktiviert ist. Während Anwendungen den Befehl MCI_SETVIDEO verwenden sollten, um diese Funktion zu steuern, müssen digitale Videogeräte dieses Flag weiterhin unterstützen. Der Standardwert, nachdem ein geöffneter aktiviert ist.

MCI_SET_ON

Aktiviert die Videoausgabe.

Bei Digital-Video-Geräten verweist der lpSetVideo-Parameter auf eine MCI_DGV_SETVIDEO_PARMS-Struktur .

Die folgenden zusätzlichen Flags werden mit dem Gerätetyp "vcr" verwendet:

MCI_VCR_SETVIDEO_RECORD

Legt die Videoaufzeichnung auf ein oder aus fest. Wird in Verbindung mit einem der folgenden Flags verwendet:

• MCI_SET_ON. Videoaufzeichnung ein.
• MCI_SET_OFF. Videoaufzeichnung deaktiviert. Es kann erforderlich sein, zuerst die Assemble-Aufzeichnung zu deaktivieren (mit dem Befehl MCI_SET mit deaktiviertem MCI_VCR_SET_ASSEMBLE_RECORD-Flag ), bevor die Videoaufzeichnung deaktiviert werden kann.

MCI_TRACK

Der dwTrack-Member der durch lpSetVideo identifizierten Struktur gibt an, welche Spur vom Befehl betroffen ist.

MCI_VCR_SETVIDEO_SOURCE

Legt die Videoquelle fest und muss mit dem flag MCI_VCR_SETVIDEO_TO verwendet werden.

MCI_VCR_SETVIDEO_MONITOR

Legt den Videoquellenmonitor fest und muss mit dem flag MCI_VCR_SETVIDEO_TO verwendet werden.

MCI_VCR_SETVIDEO_TO

Das dwTo-Element der durch lpSetVideo identifizierten Struktur enthält eine der folgenden Konstanten:

**MCI\_VCR\_SRC\_TYPE\_TUNER**

**MCI\_VCR\_SRC\_TYPE\_LINE**

**MCI\_VCR\_SRC\_TYPE\_AUX**

**MCI\_VCR\_SRC\_TYPE\_GENERIC**

**MCI\_VCR\_SRC\_TYPE\_MUTE**

**MCI\_VCR\_SRC\_TYPE\_OUTPUT**

**MCI\_VCR\_SRC\_TYPE\_RGB**

**MCI\_VCR\_SETVIDEO\_NUMBER**

Der dwNumber-Member der durch lpSetVideo identifizierten Struktur enthält die zu verwendende Videoeingabe (des im dwTo-Member angegebenen Typs).

Bei VcR-Geräten verweist der lpSetVideo-Parameter auf eine MCI_VCR_SETVIDEO_PARMS-Struktur .

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Header	Mmsystem.h (windows.h einschließen)

Siehe auch

MCI

MCI-Befehle