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
);
      

Parameter

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 assemblieren	Im 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 on	Deaktiviert 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 ein	Deaktiviert 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 Indexzeit	Legt 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 Ausschalten	Legt 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 EP	Legt 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 suchen	Wä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 30	Legt 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 Nachverfolgung	Passt 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.

Rückgabewert

Gibt null zurück, wenn der Vorgang erfolgreich war oder andernfalls ein Fehler.

Bemerkungen

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

Beispiele

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

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

pause

Speichern

stop