set-Befehl
Hinweis
Bias-freie Kommunikation Microsoft unterstützt eine vielfältige und inklusionäre Umgebung. In diesem Dokument gibt es Verweise auf das Wort "Slave". Im Microsoft Style Guide for Bias-Free Communications wird dies als ausgrenzender Begriff erkannt. Diese Formulierung wird verwendet, da es sich derzeit um die Formulierung handelt, die in den Befehlen verwendet wird. Aus Gründen der 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.
Mit dem Befehl set werden Steuerungseinstellungen für das Gerät festgelegt. CD-Audio-, Digital-Video-, MIDI-Sequencer-, VCR-, Videodisc-, Video-Overlay- und Waveform-Audio-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("set %s %s %s"),
lpszDeviceID,
lpszSetting,
lpszFlags
);
-
lpszDeviceID
-
Bezeichner eines MCI-Geräts. Dieser Bezeichner oder Alias wird zugewiesen, wenn das Gerät geöffnet wird.
-
lpszSetting
-
Flag zum Einrichten von Steuerelementeinstellungen. In der folgenden Tabelle sind Gerätetypen aufgeführt, die den Befehl set und die von jedem Typ verwendeten Flags erkennen.
Gerätetyp Befehlsflags cdaudio - Audio all off
- Audio all on
- Audio nicht mehr
- Audio eingeschaltet
- Audio direkt aus
- Audio direkt ein
- Tür geschlossen
- Tür geöffnet
- Zeitformat millisekunden
- zeitformat msf
- Zeitformat tmsf
digitalvideo - Audio all off
- Audio all on
- Audio nicht mehr
- Audio eingeschaltet
- Audio direkt aus
- Audio direkt ein
- Tür geschlossen
- Tür geöffnet
- Dateiformat
- suchen genau auf
- genau suchen
- Geschwindigkeitsfaktor
- Dateiformat nach wie vor
- Zeitformatrahmen
- Zeitformat millisekunden
- Video aus
- Video zu
overlay - Audio all off
- Audio all on
- Audio nicht mehr
- Audio eingeschaltet
- Audio direkt aus
- Audio direkt ein
- Tür geschlossen
- Tür geöffnet
- Video aus
- Video zu
sequencer - Audio all off
- Audio all on
- Audio nicht mehr
- Audio eingeschaltet
- Audio direkt aus
- Audio direkt ein
- Tür geschlossen
- Tür geöffnet
- master MIDI
- master keine
- master SMPTE
- Offsetzeit
- Portzuordnung
- port none
- port port_number
- Slavedatei
- slave MIDI
- slave none
- Slave-SMPTE
- tempo tempo_value
- Zeitformat millisekunden
- Zeitformat SMPTE fps
- Zeitformat SMPTE 30 Drop
- Zeitformat-Songzeiger
Vcr - Datensatz zusammensetzen auf
- Datensatz aus assemblieren
- Audio all off
- Audio all on
- Audio nicht mehr
- Audio eingeschaltet
- Audio direkt aus
- Audio direkt ein
- Uhrzeit
- Zählerformat
- Zählerwert
- Tür geschlossen
- Tür geöffnet
- Indexindikator
- Indexdatum
- Indexzeit
- Indexzeit
- Codelänge
- Pausentimeout
- Postroll-Dauer :
- duration
- Einschalten
- Ausschalten
- Prerolldauer
- Datensatzformat SP
- Datensatzformat LP
- Datensatzformat EP
- Geschwindigkeitsfaktor
- Zeitformatrahmen
- Zeitformat hms
- Zeitformat millisekunden
- zeitformat msf
- Zeitformat SMPTE fps
- Zeitformat SMPTE 30 Drop
- Zeitformat tmsf
- Zeitmodusindikator
- Zeitmoduserkennung
- Zeitmodus-Timecode
- Tracking plus
- Nachverfolgung minus
- Zurücksetzung nach der Nachverfolgung
videodisc - Audio all off
- Audio all on
- Audio nicht mehr
- Audio eingeschaltet
- Audio direkt aus
- Audio direkt ein
- Tür geschlossen
- Tür geöffnet
- Zeitformatrahmen
- Zeitformat hms
- Zeitformat millisekunden
- Zeitformatverfolgung
- Video aus
- Video zu
Waveaudio - ganzzahlige Ausrichtung
- beliebige Eingabe
- beliebige Ausgabe
- Audio all off
- Audio all on
- Audio nicht mehr
- Audio eingeschaltet
- Audio direkt aus
- Audio direkt ein
- bitspersample bit_count
- bytespersec byte_rate
- Kanäle channel_count
- Tür geschlossen
- Tür geöffnet
- Formattag pcm
- Tag formatieren
- Ganzzahlige Eingabe
- Ausgabe-Ganzzahl
- SamplesPersec Integer
- Zeitformatbytes
- Zeitformat millisekunden
- Zeitformatbeispiele
In der folgenden Tabelle sind die Flags aufgeführt, die im lpszSetting-Parameter angegeben werden können, und ihre Bedeutungen.
Wert Bedeutung ganzzahlige Ausrichtung Legt die Ausrichtung von Datenblöcken relativ zum Anfang der Daten fest, die an das Waveform-Audiogerät übergeben werden. Die Datei wird in diesem Format gespeichert. beliebige Eingabe Verwenden Sie bei der Aufzeichnung eine beliebige Eingabe, die das aktuelle Format unterstützt. Dies ist die Standardeinstellung. beliebige Ausgabe Verwenden Sie beim Wiedergeben eine beliebige Ausgabe, die das aktuelle Format unterstützt. Dies ist die Standardeinstellung. Datensatz zusammensetzen auf
Datensatz aus assemblierenIm Assemble-Modus werden alle Spuren wie vom Gerät definiert aufgezeichnet. Die meisten VCRs befinden sich standardmäßig im Assemble-Modus. Audio all off
Audio all onDeaktiviert oder aktiviert die Audioausgabe. Videoüberlagerungsgeräte, der MCISEQ-Sequenzer und das MCIWAVE-Waveform-Audiogerät unterstützen dieses Flag nicht. Audio nicht mehr
Audio eingeschaltet
Audio direkt aus
Audio direkt einDeaktiviert oder aktiviert die Ausgabe entweder auf dem linken oder rechten Audiokanal. Videoüberlagerungsgeräte, der MCISEQ-Sequenzer und das MCIWAVE-Waveform-Audiogerät unterstützen dieses Flag nicht. bitspersample bit_count Legt die Anzahl der Bits pro PCM -Beispiel (Pulse Code Modulation) fest, das wiedergegeben oder aufgezeichnet wird. Die Datei wird in diesem Format gespeichert. bytespersec byte_rate Legt die durchschnittliche Anzahl abgespielter oder aufgezeichneter Bytes pro Sekunde fest. Die Datei wird in diesem Format gespeichert. Kanäle channel_count Legt die Kanäle für die Wiedergabe und Aufzeichnung fest. Die Datei wird in diesem Format gespeichert. Uhrzeit Legt die Zeit für die externe Uhr auf Zeit fest. Das Format wird als ganzzahlige Lange ohne Vorzeichen angegeben. Zählerformat Legen Sie das Zeitformat für den Zähler fest, das von status "counter" zurückgegeben wird. Informationen zu anwendbaren Typen finden Sie im Befehl " Zeitformat". Zählerwert Legt den VCR-Zähler auf den angegebenen Wert fest. Der Wert muss im aktuellen Leistungsindikatorformat angegeben werden. Weitere Informationen finden Sie im Befehl " Counterformat" festlegen. Tür geschlossen Zieht das Fach zurück und schließt die Tür, wenn möglich. Für Videorekorder lädt das Band automatisch. Tür geöffnet Öffnet die Tür und wirft nach Möglichkeit das Fach oder das Band aus. Dateiformat Gibt ein Dateiformat an, das für Speicher- oder Aufzeichnungsbefehle verwendet wird. Wenn dies nicht angegeben wird, kann dies standardmäßig auf ein vom Gerätetreiber definiertes Format verwendet werden. Wenn das angegebene Dateiformat mit dem aktuell ausgewählten Algorithmus und der ausgewählten Qualität in Konflikt tritt, werden sie in die Standardwerte für das Dateiformat geändert. Die folgenden Dateiformate werden definiert: - avi: Gibt das AVI-Format an.
- avss: Gibt das AVSS-Format an.
- dib: Gibt das DIB-Format an.
- jfif: Gibt das JFIF-Format an.
- jpeg: Gibt das JPEG-Format an.
- mpeg: Gibt das MPEG-Format an.
- rdib: Gibt das RLE-DIB-Format an.
- rjpeg: Gibt das RJPEG-Format an.
Formattag pcm Legt den Formattyp für die Wiedergabe und Aufzeichnung auf PCM fest. Die Datei wird in diesem Format gespeichert. Tag formatieren Legt den Formattyp für die Wiedergabe und Aufzeichnung fest. Die Datei wird in diesem Format gespeichert. Indexzeitcode
Indexindikator
Indexdatum
IndexzeitLegt den aktuellen Anzeigebildschirm auf dem Videorekorder fest. Ganzzahlige Eingabe Legt den Audiokanal fest, der als Eingabe verwendet wird. Längendauer Legt die vom Benutzer angegebene Länge des Bandes im Videorekorder fest. Diese Länge wird vom status -Befehl "length" zurückgegeben und aus Gründen der Kompatibilität mit Anwendungen bereitgestellt, die diesen Befehl zum Zurückgeben einer gültigen Länge erfordern. master Midi Legt den MIDI-Sequencer als Synchronisierungsquelle fest. Synchronisierungsdaten werden im MIDI-Format gesendet. Dieses Flag wird vom MCISEQ-Sequencer nicht unterstützt. master keine Verhindert, dass der MIDI-Sequencer Synchronisierungsdaten sendet. Dieses Flag wird vom MCISEQ-Sequencer nicht unterstützt. master smpte Legt den MIDI-Sequencer als Synchronisierungsquelle fest. Synchronisierungsdaten werden im SMPTE-Format (Society of Motion Picture and Television Engineers) gesendet. Dieses Flag wird vom MCISEQ-Sequencer nicht unterstützt. Offsetzeit Legt die SMPTE-Offsetzeit fest. Der Offset ist die Anfangszeit einer SMPTE-basierten Sequenz. Die Zeit wird als hh ausgedrückt: mm: ss: ff, wobei hh für Stunden, mm für Minuten, ss für Sekunden und ff für Frames steht. Ausgabe-Ganzzahl Legt den Audiokanal fest, der als Ausgabe verwendet wird. Pausentimeout Legt die maximale Dauer eines Pausenbefehls in Millisekunden fest. Ein Timeoutwert von 0 gibt an, dass kein Timeout auftritt. Dauer nach der Registrierung Legt die Länge im aktuellen Zeitformat fest, die erforderlich ist, um den VCR-Transport zu bremsen, wenn ein Befehl zum Anhalten oder Anhalten ausgegeben wird. Portzuordnung Legt den MIDI-Mapper als Port fest, der die MIDI-Nachrichten empfängt. Dieser Befehl schlägt fehl, wenn der MIDI-Mapper oder ein Port, der benötigt wird, von einer anderen Anwendung verwendet wird. port none Deaktiviert das Senden von MIDI-Nachrichten. Dieser Befehl schließt auch einen MIDI-Port. port port_number Legt den MIDI-Port fest, der die MIDI-Nachrichten empfängt. Dieser Befehl schlägt fehl, wenn der Port, den Sie öffnen möchten, von einer anderen Anwendung verwendet wird. Einschalten
AusschaltenLegt das Ein- oder Ausschalten des Geräts fest. Prerolldauer Legt die Länge im aktuellen Zeitformat fest, die zum Stabilisieren der VCR-Ausgabe benötigt wird. Datensatzformat SP
Datensatzformat LP
Datensatzformat EPLegt den Aufzeichnungsmodus für den VCR auf SP für Standardwiedergabe, EP für erweiterte Wiedergabe oder LP für lange Wiedergabe fest. Diese Werte sind nicht als VHS-spezifisch vorgesehen. Sie werden drei beliebigen geeigneten Modi mit anderen Bandformaten zugeordnet. Sp wird beispielsweise der schnellsten Aufzeichnung mit höchster Qualität zugeordnet. SamplesPersec Integer Legt die Abtastrate für die Wiedergabe und Aufzeichnung fest. Die Datei wird in diesem Format gespeichert. suchen genau auf
genau suchenWählt einen von zwei Suchmodi aus. Bei "suchen genau ein" wird seek immer zu dem angegebenen Frame verschoben. Mit "Genau aus suchen" wechselt seek zum nächstgelegenen Schlüsselbild vor dem angegebenen Frame. Slavedatei Legt fest, dass der MIDI-Sequencer Dateidaten als Synchronisierungsquelle verwendet. Dies ist die Standardeinstellung. Slave-Midi Legt den MIDI-Sequencer so fest, dass eingehende MIDI-Daten für die Synchronisierungsquelle verwendet werden. Der Sequencer erkennt Synchronisierungsdaten mit dem MIDI-Format. Der MCISEQ-Sequencer unterstützt dieses Flag nicht. slave none Legt fest, dass der MIDI-Sequencer die Synchronisierung ignoriert. Slave-Smpte Legt den MIDI-Sequencer so fest, dass eingehende MIDI-Daten für die Synchronisierungsquelle verwendet werden. Der Sequencer erkennt Synchronisierungsdaten mit dem SMPTE-Format. Der MCISEQ-Sequencer unterstützt dieses Flag nicht. Geschwindigkeitsfaktor Legt die relative Geschwindigkeit der Video- und Audiowiedergabe aus dem Arbeitsbereich fest. Faktor ist das Verhältnis zwischen der nominalen Bildfrequenz und der gewünschten Bildfrequenz, wobei die nominale Bildfrequenz als 1000 angegeben wird. (Eine Rate von 500 ist eine halbe normale Geschwindigkeit, 2000 ist doppelt normal, usw.) Wenn Sie die Geschwindigkeit auf 0 (null) festlegen, wird das Video so schnell wie möglich ohne Frames und ohne Audio wiedergegeben. Dateiformat für stille Dateien Gibt das Dateiformat an, das für Aufzeichnungsbefehle verwendet wird. tempo tempo_value Legt das Tempo der Sequenz entsprechend dem aktuellen Zeitformat fest. Bei einer PPQN-basierten Datei wird die tempo_value als Takte pro Minute interpretiert. Bei einer SMPTE-basierten Datei wird die tempo_value als Frames pro Sekunde interpretiert. Zeitformatbytes Legt in einem PCM-Dateiformat das Zeitformat auf Bytes fest. Alle Positionsinformationen werden nach diesem Befehl als Bytes angegeben. Zeitformatrahmen Legt das Zeitformat auf Frames fest. Alle Befehle, die Positionswerte verwenden, nehmen Frames an. Wenn das Gerät geöffnet wird, sind Frames der Standardmodus. Unterstützt von Videodiscs im CAV-Format. zeitformat hms Legt das Zeitformat auf Stunden, Minuten und Sekunden fest. Alle Befehle, die Positionswerte verwenden, nehmen HMS an. HMS ist das Standardformat für CLV-Videodiscs. Geben Sie einen HMS-Wert als hh:mm:ss an, wobei hh für Stunden, mm für Minuten und ss für Sekunden steht. Sie können ein Feld weglassen, wenn es und alle folgenden Felder null sind. Beispielsweise sind 3, 3:0 und 3:0:0 alle gültige Möglichkeiten, um 3 Stunden auszudrücken. Zeitformat millisekunden Legt das Zeitformat auf Millisekunden fest. Alle Befehle, die Positionswerte verwenden, nehmen Millisekunden an. Sie können Millisekunden als "ms" kürzen. Für Sequencergeräte legt die Sequenzdatei das Standardformat auf PPQN oder SMPTE fest. Videoüberlagerungsgeräte unterstützen dieses Flag nicht. zeitformat msf Legt das Zeitformat auf Minuten, Sekunden und Frames fest. Für alle Befehle, die Positionswerte verwenden, wird MSF (das Standardformat für CD-Audio) angenommen. Geben Sie einen MSF-Wert als mm:ss:ff an, wobei mm für Minuten, ss für Sekunden und ff für Frames steht. Sie können ein Feld weglassen, wenn es und alle folgenden Felder null sind. Beispielsweise sind 3, 3:0 und 3:0:0 gültige Möglichkeiten, um 3 Minuten auszudrücken.
Die MSF-Felder weisen die folgenden Maximalwerte auf:- Minuten 99
- Sekunden 59
- Frames 74
Zeitformatbeispiele Legt das Zeitformat auf Beispiele fest. Alle Positionsinformationen werden nach diesem Befehl als Beispiele angegeben. Zeitformat smpte 24
Zeitformat smpte 25
Zeitformat smpte 30Legt das Zeitformat auf eine SMPTE-Framerate fest. Legt für Videorekorder das Zeitformat auf hh:mm:ss:ff fest, wobei die gesetzlichen Werte 00:00:00:00 bis 23:59:xx und xx eins kleiner als die Frames pro Sekunde sind, wie in der Zahl 24, 25 oder 30 angegeben, wie im Flag angegeben. Bei der Eingabe Doppelpunkte (:) sind erforderlich, um die Komponenten zu trennen. Die am wenigsten signifikanten Einheiten können weggelassen werden, wenn sie 00 sind; Beispielsweise ist 02:00 identisch mit 02:00:00:00. Für alle Befehle, die Positionswerte verwenden, wird das SMPTE-Format angenommen.
Die Sequenzdatei legt das Standardformat auf PPQN oder SMPTE fest.Zeitformat smpte 30 Drop Legt das Zeitformat auf die Bildabbruchrate SMPTE 30 fest. Für Videorekorder, identisch mit SMPTE 30, mit der Ausnahme, dass bestimmte Timecodepositionen aus dem Format entfernt werden, damit die aufgezeichneten Timecodepositionen für jeden Frame (bei der NTSC-Bildrate von 29,97 fps) echtzeit (bei 30 fps) entsprechen. Timecodepositionen, die gelöscht werden, sind wie folgt: zwei minutenauf der Minute für die ersten neun von zehn Minuten aufgezeichneter Inhalte. Bei 01:04:59:29 wäre die nächste Zeitcodeposition beispielsweise 01:05:00:02, nicht 01:05:00:00. Für alle Befehle, die Positionswerte verwenden, wird das SMPTE-Format angenommen.
Die Sequenzdatei legt das Standardformat auf PPQN oder SMPTE fest.Zeitformat-Songzeiger Legt das Zeitformat auf den Songzeiger (sechzehnte Noten) fest. Alle Befehle, die Positionswerte verwenden, gehen von Songzeigereinheiten aus. Dieses Flag ist nur für eine Sequenz vom Divisionstyp PPQN gültig. Zeitformat tmsf Legt das Zeitformat auf Spuren, Minuten, Sekunden und Frames fest. Alle Befehle, die Positionswerte verwenden, nehmen TMSF an. Geben Sie einen TMSF-Wert als tt:mm:ss:ff an, wobei tt für Tracks, mm für Minuten, ss für Sekunden und ff für Frames steht. Sie können ein Feld weglassen, wenn es und alle folgenden Felder null sind. Beispielsweise sind 3, 3:0, 3:0:0 und 3:0:0:0 alle gültigen Methoden, um Track 3 auszudrücken.
Die TMSF-Felder weisen die folgenden maximalen Werte auf:- Titel 99
- Minuten 90
- Sekunden 59
- Frames 74
Zeitformatspur Legt das Positionsformat auf Tracks fest. Alle Befehle, die Positionswerte verwenden, nehmen Spuren an. Zeitmodusindikator Legt den Positionsinformationsmodus fest, um die VcR-Indikatoren zu verwenden. Zeitmoduserkennung Legt den Positionsinformationsmodus basierend auf der Erkennung von Timecodeinformationen auf dem Band fest. Wenn Timecodeinformationen erkannt werden, wird der Zeittyp auf "timecode" festgelegt. Andernfalls wird der Zeittyp auf "counter" festgelegt. "Erkennen" ist ein spezieller Modus. Wenn der Treiber geöffnet, ein neues Band eingefügt oder der Befehl "Zeitmodus" ausgegeben wird, überprüft der Treiber den aktuellen Zeitmodus, der auf dem Band verfügbar ist, und legt "time type" entweder auf "timecode" oder "counter" fest. Nachdem "Zeittyp" festgelegt wurde, ändert der Treiber ihn erst, wenn eine der oben genannten Bedingungen erneut auftritt. Timecode im Zeitmodus Legt den Positionsinformationsmodus fest, um "Timecode"-Informationen auf dem Band zu verwenden. Tracking plus
Nachverfolgung minus
Zurücksetzung nach der NachverfolgungPasst die Geschwindigkeit des Videobandtransports in feinen Schritten an. Verwenden Sie die "Tracking"-Flags, wenn ein verrauschendes Bild von einem Videorekorder abgerufen wird. "Tracking plus" erhöht die Transportgeschwindigkeit. "Tracking minus" verringert die Transportgeschwindigkeit. "Tracking Reset" gibt die Nachverfolgungsanpassung auf 0 zurück. Video aus Deaktiviert die Videoausgabe. Video zu Aktiviert die Videoausgabe. -
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.
Gibt null zurück, wenn der Vorgang erfolgreich war oder andernfalls ein Fehler.
Mehrere Eigenschaften von Waveform-Audiodaten werden definiert, wenn die Datei zum Speichern der Daten erstellt wird. Diese Eigenschaften beschreiben, wie die Daten in der Datei strukturiert sind und nach Beginn der Aufzeichnung nicht mehr geändert werden können. In der folgenden Liste werden diese Eigenschaften identifiziert:
- Ausrichtung
- bitspersample
- bytespersec
- channels
- Formattag
- samplespersec
Der folgende Befehl legt das Zeitformat auf Millisekunden fest und legt das Waveform-Audioformat auf 8 Bit, Mono, 11 kHz fest.
set mysound time format ms bitspersample 8 channels 1 samplespersec 11025
Anforderung | Wert |
---|---|
Unterstützte Mindestversion (Client) |
Windows 2000 Professional [nur Desktop-Apps] |
Unterstützte Mindestversion (Server) |
Windows 2000 Server [nur Desktop-Apps] |