MCI _ SET-Befehl

Hinweis

Bias-free Communication Microsoft unterstützt eine vielfältige und inklusionsbasierte Umgebung. In diesem Dokument gibt es Verweise auf das Wort "slave". Microsoft Style Guide for Bias-Free Communications erkennt dies als Ausschlusswort. Diese Formulierung wird verwendet, da sie derzeit in den Befehlen verwendet wird. Zur Konsistenz enthält dieses Dokument dieses Wort. Wenn dieses Wort in den Befehlen geändert wird, korrigieren wir dieses Dokument so, dass es ausgerichtet ist.

Der Befehl MCI _ SET legt Geräteinformationen fest. CD-Audio, digital-video, RADAR sequencer, VCR, videodisc, video-overlay und waveform-audio erkennen diesen Befehl.

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

MCIERROR mciSendCommand(
  MCIDEVICEID wDeviceID, 
  MCI_SET, 
  DWORD dwFlags, 
  (DWORD) (LPMCI_SET_PARMS) lpSet
);

Parameter

wDeviceID

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

Dwflags

MCI _ NOTIFY, MCI _ WAIT oder bei Digitalvideo- und VCR-Geräten MCI _ TEST. Informationen zu diesen Flags finden Sie unter Die Warte-, Benachrichtigungs- und Testflags.

lpSet

Zeiger auf eine MCI _ SET _ PARMS-Struktur. (Geräte mit erweiterten Befehlssätzen ersetzen diese Struktur möglicherweise durch eine gerätespezifische Struktur.)

Rückgabewert

Gibt 0 (null) zurück, wenn erfolgreich, andernfalls ein Fehler.

Hinweise

Die folgenden zusätzlichen Flags gelten für alle Geräte, die MCI _ SET unterstützen:

MCI _ SET _ AUDIO

Eine Audiokanalnummer ist im dwAudio-Member der -Struktur enthalten, die durch lpSet identifiziert wird. Dieses Flag muss mit MCI _ SET _ ON oder MCI SET OFF verwendet _ _ werden. Verwenden Sie eine der folgenden Konstanten, um die Kanalnummer anzugeben:

MCI _ SET _ AUDIO _ ALL

Alle Audiokanäle.

MCI _ SET _ AUDIO _ LEFT

Linker Kanal.

MCI _ SET _ AUDIO _ RIGHT

Rechter Kanal.

MCI _ SET _ DOOR _ CLOSED

Schließt die Medienabdeckung (falls dies der Fall ist).

MCI _ SET _ DOOR _ OPEN

Öffnet die Medienabdeckung (sofern dies der Fall ist).

MCI _ SET _ OFF

Deaktiviert den angegebenen Video- oder Audiokanal.

MCI _ SET _ ON

Aktiviert den angegebenen Video- oder Audiokanal.

MCI _ SET _ TIME _ FORMAT

Ein Zeitformatparameter ist im dwTimeFormat-Member der struktur enthalten, die durch lpSet identifiziert wird. Die folgenden Flags werden mit diesem Flag verwendet:

BYTES IM _ _ MCI-FORMAT

Innerhalb eines PCM-Datenformats (Pulse Code Codes) ändert die Zeit-Memberbeschreibung für die Eingabe oder Ausgabe in Bytes. Wird vom Waveaudio-Gerätetyp erkannt.

_ _ MCI-FORMATFRAMES

Nachfolgende Befehle verwenden Frames. Wird von den Gerätetypen digitalvideo, vcr und videodisc erkannt.

_MCI-FORMAT _ HMS

Ändert das Zeitformat in Stunden, Minuten und Sekunden. Wird von den Vcr- und videodisc-Gerätetypen erkannt.

_MCI-FORMAT _ IN MILLISEKUNDEN

Ändert das Zeitformat in Millisekunden. Wird von allen Gerätetypen erkannt.

MSF IM _ _ MCI-FORMAT

Ändert das Zeitformat in Minuten, Sekunden und Frames. Wird von den Cdaudio- und VCR-Gerätetypen erkannt.

BEISPIELE FÜR DAS _ _ MCI-FORMAT

Ändert das Zeitformat in Stichproben für die Eingabe oder Ausgabe. Wird vom Waveaudio-Gerätetyp erkannt.

MCI _ FORMAT _ SMPTE _ 24, MCI _ FORMAT _ SMPTE _ 25 und MCI _ FORMAT _ SMPTE _ 30

Legt das Zeitformat auf 24, 25 und 30 Frame SMPTE (Society of Motion Picture and Tv Engineers) fest. Wird vom Sequencer- und vcr-Gerätetypen erkannt.

_MCI-FORMAT _ SMPTE _ 30DROP

Legt das Zeitformat auf 30 Dropframe-SMPTE fest. Wird vom Sequencer- und vcr-Gerätetypen erkannt.

MCI _ FORMAT _ TMSF

Ändert das Zeitformat in Spuren, Minuten, Sekunden und Frames. (MCI verwendet fortlaufende Tracknummern.) Wird von den Cdaudio- und VCR-Gerätetypen erkannt.

MCI _ SET _ VIDEO

Legt das Videosignal ein oder aus fest. Dieses Flag muss mit MCI SET ON oder _ _ MCI _ SET OFF verwendet _ werden. Geräte ohne Video geben MCIERR _ UNSUPPORTED _ FUNCTION zurück.

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

MCI _ DGV _ SET _ FILEFORMAT

Ein Dateiformatparameter ist im dwFileFormat-Member der struktur enthalten, die durch lpSet identifiziert wird. Bei Digitalvideogeräten wird das Dateiformat für Speicher- oder Erfassungsbefehle verwendet. Wenn dies nicht angegeben wird, wird möglicherweise standardmäßig ein vom Gerätetreiber definiertes Format verwendet. Wenn das angegebene Dateiformat mit dem aktuell ausgewählten Algorithmus und der Qualität in Konflikt steht, werden sie in die Standardwerte für das Dateiformat geändert. Die folgenden Dateiformatkonst constants werden definiert:

MCI _ DGV _ FF _ AVI

AVI-Format.

MCI _ DGV _ FF _ AVSS

AVSS-Format.

MCI _ DGV _ FF _ DIB

DIB-Format.

MCI _ DGV _ FF _ JFIF

JFIF-Format.

MCI _ DGV _ FF _ JPEG

JPEG-Format.

MCI _ DGV _ FF _ MPEG

MPEG-Format.

MCI _ DGV _ FF _ RDIB

RLE DIB-Format.

MCI _ DGV _ FF _ RJPEG

RJPEG-Format.

MCI _ DGV _ SET _ SEEK _ EXACTLY

Legt das format fest, das für die Positionierung verwendet wird. Dieses Flag muss mit MCI SET ON oder MCI SET OFF verwendet _ _ _ _ werden. Wenn MCI SET ON angegeben ist, greift die _ Wiedergabe oder Aufzeichnung genau auf den Frame _ zu, der mit dem MCI _ FROM-Flag angegeben wurde. Dies kann zu einer zusätzlichen Verzögerung kommen, wenn der angeforderte Frame kein Keyframe ist. Wenn MCI _ SET _ OFF angegeben ist, sucht das Gerät nach einem Keyframebild, das dem angeforderten Frame vorausgeht. Bei einigen Dateien und Geräten kann dies der erste Frame der Datei sein. Der Standardwert für dieses Flag ist geräteabhängig.

MCI _ DGV _ SET _ SPEED

Ein speed-Parameter ist im dwSpeed-Member der durch lpSet identifizierten Struktur enthalten. Die Geschwindigkeit wird als Verhältnis zwischen der nominalen Bildfrequenz und der gewünschten Bildfrequenz angegeben, wobei die nominale Bildfrequenz als 1000 festgelegt ist. Die halbe Geschwindigkeit ist 500 und die doppelte Geschwindigkeit 2000. Der zulässige Geschwindigkeitsbereich hängt vom Gerät und möglicherweise auch von der Datei ab.

MCI _ DGV _ SET _ STILL

Bei Verwendung mit MCI _ DGV _ SET _ FILEFORMAT legt MCI _ SET das Dateiformat fest, das für Aufzeichnungsbefehle verwendet wird.

Bei Digitalvideogeräten verweist der lpSet-Parameter auf eine MCI _ DGV _ SET _ PARMS-Struktur.

Die folgenden zusätzlichen Flags werden mit dem Sequencergerätetyp verwendet:

MCI _ SEQ _ FORMAT _ SONGPTR

Legt das Zeitformat auf Einheiten für Titelzeiger fest.

MCI _ SEQ _ SET _ MASTER

Legt den Sequencer als Quelle der Synchronisierungsdaten fest und gibt an, dass der Typ der Synchronisierung im dwMaster-Member der durch lpSet identifizierten Struktur angegeben wird. MCISEQ gibt DIE _ NICHT UNTERSTÜTZTE MCIERR-FUNKTION _ zurück. Die folgenden Konstanten werden für den Synchronisierungstyp definiert:

MCI _ SEQ _ PARTS

Der Sequencer sendet Synchronisierungsdaten im FORMAT FORMAT .

MCI _ SEQ _ SMPTE

Der Sequencer sendet Synchronisierungsdaten im SMPTE-Format.

MCI _ SEQ _ NONE

Der Sequencer sendet keine Synchronisierungsdaten.

MCI _ SEQ _ SET _ OFFSET

Ändert den SMPTE-Offset einer Sequenz in den vom dwOffset-Member der durch lpSet identifizierten Struktur angegebenen Offset. Dies betrifft nur Sequenzen mit einem SMPTE-Divisionstyp.

MCI _ SEQ _ _ SET-PORT

Legt den OUTPUT-PORT einer Sequenz auf den wert fest, der durch den BEzeichner des GERÄTS im dwPort-Member der durch lpSet identifizierten Struktur angegeben wird. Das Gerät schließt den vorherigen Port (falls vorhanden) und versucht, den neuen Port zu öffnen und zu verwenden. Wenn ein Fehler auftritt, wird ein Fehler zurückgegeben, und der zuvor verwendete Port (falls vorhanden) wird erneut geöffnet. Die folgenden Konstanten werden für die Ports definiert:

MCI _ SEQ _ NONE

Schließt den zuvor verwendeten Port (falls vorhanden). Der Sequencer verhält sich genau so, als wäre ein Port geöffnet, es sei denn, es wird keine FEHLERMELDUNG gesendet.

MAPPER FÜR _ MAPPER

Legt den Port fest, der für die MAPPER-Mapper-Schnittstelle geöffnet ist.

MCI _ SEQ _ SET _ SLAVE

Legt den Sequencer auf den Empfang von Synchronisierungsdaten fest und gibt an, dass der Typ der Synchronisierung im dwSlave-Member der durch lpSet identifizierten Struktur angegeben wird. MCISEQ gibt DIE _ NICHT UNTERSTÜTZTE MCIERR-FUNKTION _ zurück. Die folgenden Konstanten werden für den Synchronisierungstyp definiert:

MCI _ SEQ _ FILE

Legt den Sequencer auf den Empfang von Synchronisierungsdaten fest, die in der CSV-Datei enthalten sind.

MCI _ SEQ _ PARTS

Legt den Sequencer so fest, dass er DIE SYNCHRONISIEREN-Synchronisierungsdaten empfängt.

MCI _ SEQ _ NONE

Legt den Sequencer so fest, dass Synchronisierungsdaten in einem STREAMING-Stream ignoriert werden.

MCI _ SEQ _ SMPTE

Legt den Sequencer auf den Empfang von SMPTE-Synchronisierungsdaten fest.

MCI _ SEQ _ SET _ TEMPO

Ändert das Tempo der SEQUENCE-Sequenz in die vom dwTempo-Member der -Struktur, auf die von lpSet gezeigt wird, angegebene Geschwindigkeit. Für Sequenzen mit dem Divisionstyp PPQN wird tempo in Takten pro Minute angegeben. für Sequenzen mit dem Divisionstyp SMPTE wird tempo in Frames pro Sekunde angegeben.

Bei Sequencergeräten verweist der lpSet-Parameter auf eine MCI _ SEQ _ SET _ PARMS-Struktur.

Die folgenden zusätzlichen Flags werden mit dem Vcr-Gerätetyp verwendet:

MCI _ VCR _ SET _ ASSEMBLE _ RECORD

Legt das Gerät fest, das im Assembler- oder Einfügemodus erfasst werden soll (wenn der Assembler deaktiviert ist, ist der Einfügemodus eingeschaltet und umgekehrt). Verwenden Sie mit einem der folgenden Flags:

MCI _ SET _ ON

Legt den Assemblerdatensatz auf fest und deaktiviert den Einfügedatensatz. Zeichnet alle Video-, Audio- und Zeitcodespuren auf.

MCI _ SET _ OFF

Legt den Assemblerdatensatz deaktiviert und den Einfügedatensatz aktiviert. Wenn der Assemblerdatensatz deaktiviert ist, können einzelne Video-, Audio- und Zeitcodespuren für die Aufzeichnung ausgewählt werden.

MCI _ VCR _ SET _ CLOCK

Der dwClock-Member der von lpSet identifizierten Struktur enthält die neue Uhrzeit.

MCI _ VCR _ SET _ COUNTER _ FORMA

Der dwCounterFormat-Member der von lpSet identifizierten Struktur enthält eine Konstante, die das neue Indikatorzeitformat angibt, das vom Statusindikator verwendet werden soll. Eine Liste der gültigen Konstanten finden Sie unter MCI _ SET TIME FORMAT in der Liste der _ _ zusätzlichen Flags für diesen Befehl.

MCI _ VCR _ SET _ COUNTER _ VALUE

Der dwCounterValue-Member der von lpSet identifizierten Struktur enthält den neuen Indikatorwert.

MCI _ VCR _ SET _ INDEX

Der dwIndex-Member der durch lpSet identifizierten Struktur enthält eine Konstante, die den Inhalt der Bildschirmanzeige angibt und eine der folgenden Sein muss:

MCI _ VCR _ INDEX _ COUNTER

Zeigt den Indikator an.

MCI _ VCR _ INDEX _ DATE

Zeigt das Datum an.

MCI _ VCR _ INDEX _ TIME

Zeigt die Zeit an.

MCI _ VCR _ INDEX _ TIMECODE

Zeigt timecode an.

Weitere Informationen finden Sie unter dem MCI _ INDEX-Befehl.

MCI _ VCR _ SET _ PAUSE _ TIMEOUT

Der dwPauseTimeout-Member der von lpSet identifizierten Struktur enthält die maximale Dauer eines Pausenbefehls in Millisekunden.

MCI _ VCR _ SET _ POSTROLL _ DURATION

Der dwPostrollDuration-Member der von lpSet identifizierten Struktur enthält die Videotapelänge im aktuellen Zeitformat, die erforderlich ist, um den VCR-Transport zu unterbrechen, wenn ein Befehl zum Beenden oder Anhalten ausgegeben wird.

MCI _ VCR _ SET _ POWER

Legt das Ein- oder Ausschalten fest. Muss mit einem der folgenden Flags verwendet werden:

MCI _ SET _ OFF

Schaltet den Netzschalter aus.

MCI _ SET _ ON

Schaltet ein.

MCI _ VCR _ SET _ PREROLL _ DURATION

Der dwPrerollDuration-Member der von lpSet identifizierten Struktur enthält die Videobandlänge im aktuellen Zeitformat, die zur Stabilisierung der VCR-Ausgabe erforderlich ist.

MCI _ VCR _ SET _ RECORD _ FORMAT

Der dwRecordFormat-Member der von lpSet identifizierten Struktur enthält eine Konstante, die die Datensatzgeschwindigkeit beschreibt, die eine der folgenden Sein muss:

MCI _ VCR _ FORMAT _ EP

Zeichnet mit langsamer Geschwindigkeit auf.

MCI _ VCR _ FORMAT _ LP

Zeichnet mit mittlerer langsamer Geschwindigkeit auf.

MCI _ VCR _ FORMAT _ SP

Datensätze mit Standardgeschwindigkeit.

MCI _ VCR _ SET _ SPEED

Der dwSpeed-Member der von lpSet identifizierten Struktur enthält die neue Geschwindigkeitseinstellung, wobei 1000 die Normalgeschwindigkeit, 2000 die doppelte Geschwindigkeit und 500 die halbe Geschwindigkeit usw. ist.

MCI _ VCR _ SET _ TAPE _ LENGTH

Der dwTapeLength-Member der von lpSet identifizierten Struktur enthält die neue Länge des Bandes, vorausgesetzt, die Länge des Bands ist nicht erkennbar.

MCI _ VCR _ SET _ TIME _ MODE

Der dwTimeMode-Member der durch lpSet identifizierten Struktur enthält eine Konstante, die den neuen Positionszeitmodus angibt. Die folgenden Konstanten sind gültig:

MCI _ VCR _ TIME _ COUNTER

Erzwingt, dass das Gerät den Indikator ausschließlich verwendet.

MCI _ VCR _ TIME _ DETECT

Jedes Mal, wenn ein neues Videoband in das Gerät eingefügt wird oder sich der Modus von nicht bereit bis bereit ändert, sollte das Gerät versuchen, zu ermitteln, ob auf dem Videoband ein Timecode verfügbar ist. Wenn timecode verfügbar ist, verwenden Sie timecode in allen nachfolgenden Befehlen, die Positionen angeben. Verwenden Sie andernfalls den Zähler.

MCI _ VCR _ TIME _ TIMECODE

Erzwingt, dass das Gerät ausschließlich timecode verwendet.

MCI _ VCR _ SET _ TRACKING

Passt die Geschwindigkeit des VCR-Bandtransports mit einer feinen Anpassung an und muss mit einem der folgenden Flags verwendet werden:

MCI _ VCR _ PLUS

Erhöht die Geschwindigkeit des Bandtransports.

MCI _ VCR _ MINUS

Verringert die Geschwindigkeit des Bandtransports.

MCI _ VCR _ RESET

Gibt die Nachverfolgungsanpassung auf 0 (null) zurück.

Bei VCR-Geräten zeigt der lpSet-Parameter auf eine MCI _ VCR _ SET _ PARMS-Struktur.

Das folgende zusätzliche Flag wird mit dem Gerätetyp videodisc verwendet:

MCI _ VD _ FORMAT _ TRACK

Ändert das Zeitformat in "Tracks". MCI verwendet fortlaufende Tracknummern.

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

MCI _ WAVE _ INPUT

Legt die Eingabe fest, die für die Aufzeichnung im wInput-Member der durch lpSet identifizierten Struktur verwendet wird.

MCI _ _ WAVE-AUSGABE

Legt die Ausgabe fest, die zum Wiedergeben des wOutput-Members der durch lpSet identifizierten Struktur verwendet wird.

MCI _ WAVE _ SET _ ANYINPUT

Jede Welleneingabe, die mit dem aktuellen Format kompatibel ist, kann für die Aufzeichnung verwendet werden.

MCI _ WAVE _ SET _ ANYOUTPUT

Jede Wellenausgabe, die mit dem aktuellen Format kompatibel ist, kann für die Wiedergabe verwendet werden.

MCI _ WAVE _ SET _ AVGBYTESPERSEC

Legt die Bytes pro Sekunde fest, die zum Wiedergeben, Aufzeichnen und Speichern im nAvgBytesPerSec-Member der durch lpSet identifizierten Struktur verwendet werden.

MCI _ WAVE _ SET _ BITSPERSAMPLE

Legt die Bits pro Beispiel fest, die zum Wiedergeben, Aufzeichnen und Speichern im nBitsPerSample-Member des PCM-Datenformats verwendet werden, das durch lpSet identifiziert wird.

MCI _ WAVE _ SET _ BLOCKALIGN

Legt die Blockausrichtung fest, die zum Wiedergeben, Aufzeichnen und Speichern im nBlockAlign-Member der durch lpSet identifizierten Struktur verwendet wird.

MCI _ WAVE _ SET _ CHANNELS

Die Anzahl der Kanäle wird im nChannels-Member der durch lpSet identifizierten Struktur angegeben.

MCI _ WAVE _ SET _ FORMATTAG

Legt den Formattyp fest, der zum Wiedergeben, Aufzeichnen und Speichern im wFormatTag-Member der durch lpSet identifizierten Struktur verwendet wird. Wenn Sie WAVE FORMAT PCM angeben, _ wird das Format in _ PCM geändert.

MCI _ WAVE _ SET _ SAMPLESPERSEC

Legt die Samplings pro Sekunde fest, die zum Wiedergeben, Aufzeichnen und Speichern im nSamplesPerSec-Member der durch lpSet identifizierten Struktur verwendet werden.

Bei Waveform-Audiogeräten zeigt der lpSet-Parameter auf eine MCI _ WAVE SET _ _ PARMS-Struktur.

Mehrere Eigenschaften von Waveform-Audiodaten werden definiert, wenn die Datei zum Speichern der Daten erstellt wird. Diese Eigenschaften beschreiben, wie die Daten innerhalb der Datei strukturiert sind und können nach Beginn der Aufzeichnung nicht mehr geändert werden. In der folgenden Liste von Flags werden diese Eigenschaften identifiziert:

  • MCI _ WAVE _ SET _ AVGBYTESPERSEC
  • MCI _ WAVE _ SET _ BITSPERSAMPLE
  • MCI _ WAVE _ SET _ BLOCKALIGN
  • MCI _ WAVE _ SET _ CHANNELS
  • MCI _ WAVE _ SET _ FORMATTAG
  • MCI _ WAVE _ SET _ SAMPLESPERSEC

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 (include Windows.h)

Siehe auch

MCI

MCI-Befehle