set-Befehl

Hinweis

Voreingenommene Kommunikation Microsoft unterstützt eine vielfältige und inklusionsorientierte Umgebung. In diesem Dokument gibt es Verweise auf das Wort "slave". Der Microsoft Style Guide for Bias-Free Communications erkennt dies als Ausschlusswort. Diese Formulierung wird verwendet, da es sich derzeit um die Formulierung handelt, die in den Befehlen verwendet wird. Aus Konsistenzgründen enthält dieses Dokument dieses Wort. Wenn dieses Wort in den Befehlen geändert wird, korrigieren wir dieses Dokument in Übereinstimmung.

Mit dem Befehl set werden Steuerungseinstellungen für das Gerät eingerichtet. CD-Audio-, Digital-Video-, WAVE Sequencer-, VCR-, Videodisc-, Videoüberlagerungs- und Waveform-Audiogeräte erkennen diesen Befehl.

Um diesen Befehl zu senden, rufen Sie die mciSendString-Funktion auf, wobei der lpszCommand-Parameter 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 set-Befehl und die von den einzelnen Typen verwendeten Flags erkennen.

Gerätetyp Befehlsflags
cdaudio
  • Audio all off
  • audio all on
  • Audio ausgelassen
  • audio left on
  • Audio direkt ausgeschaltet
  • Audio direkt eingeschaltet
  • Tür geschlossen
  • Door Open
  • Zeitformat (Millisekunden)
  • zeitformat msf
  • zeitformat tmsf
digitalvideo
  • Audio all off
  • audio all on
  • Audio ausgelassen
  • audio left on
  • Audio direkt ausgeschaltet
  • Audio direkt eingeschaltet
  • Tür geschlossen
  • Door Open
  • Dateiformat
  • Suchen sie genau nach
  • Suchen sie genau aus
  • Geschwindigkeitsfaktor
  • Format des Dateiformats "still"
  • Zeitformatrahmen
  • Zeitformat (Millisekunden)
  • Video aus
  • Video zu
overlay
  • Audio all off
  • audio all on
  • Audio ausgelassen
  • audio left on
  • Audio direkt ausgeschaltet
  • Audio direkt eingeschaltet
  • Tür geschlossen
  • Door Open
  • Video aus
  • Video zu
sequencer
  • Audio all off
  • audio all on
  • Audio ausgelassen
  • audio left on
  • Audio direkt ausgeschaltet
  • Audio direkt eingeschaltet
  • Tür geschlossen
  • Door Open
  • master MASTERS
  • master none
  • Master-SMPTE
  • Offsetzeit
  • Portzuordnung
  • Port "None"
  • port port_number
  • Untergeordnete Datei
  • Slave-NSDR
  • Slave None
  • Slave-SMPTE
  • tempo tempo_value
  • Zeitformat (Millisekunden)
  • Zeitformat SMPTE fps
  • Zeitformat SMPTE 30 drop
  • Zeitformattitelzeiger
Vcr
  • Datensatz zusammenstellen auf
  • Datensatz ausstellen
  • Audio all off
  • audio all on
  • Audio ausgelassen
  • audio left on
  • Audio direkt ausgeschaltet
  • Audio direkt eingeschaltet
  • Uhrzeit
  • Indikatorformat
  • Indikatorwert
  • Tür geschlossen
  • Door Open
  • Indexzähler
  • Indexdatum
  • Indexzeit
  • Indexzeit
  • codelength duration
  • Timeout anhalten
  • Dauer der Postrolls:
  • duration
  • Einschalten
  • Ausschalten
  • Dauer des Vorabrollings
  • Datensatzformat SP
  • Datensatzformat LP
  • Datensatzformat EP
  • Geschwindigkeitsfaktor
  • Zeitformatrahmen
  • Zeitformat hms
  • Zeitformat (Millisekunden)
  • zeitformat msf
  • Zeitformat SMPTE fps
  • Zeitformat SMPTE 30 drop
  • zeitformat tmsf
  • Zeitmoduszähler
  • Zeitmoduserkennung
  • Timecode im Zeitmodus
  • Nachverfolgung plus
  • Nachverfolgungs-Minus
  • Nachverfolgungsrücksetzung
videodisc
  • Audio all off
  • Audio all on
  • Audio ausgelassen
  • audio left on
  • Audio direkt ausgeschaltet
  • Audio direkt eingeschaltet
  • Tür geschlossen
  • Door Open
  • Zeitformatrahmen
  • Zeitformat hms
  • Zeitformat (Millisekunden)
  • Zeitformatspur
  • Video aus
  • Video zu
Waveaudio
  • ganzzahlige Ausrichtung
  • Beliebige Eingabe
  • Beliebige Ausgabe
  • Audio all off
  • Audio all on
  • Audio ausgelassen
  • audio left on
  • Audio direkt ausgeschaltet
  • Audio direkt eingeschaltet
  • bitspersample bit_count
  • bytespersec byte_rate
  • kanäle channel_count
  • Tür geschlossen
  • Door Open
  • format tag pcm
  • Formattagtag
  • Eingabe-Ganzzahl
  • Ausgabe ganze Zahl
  • samplespersec integer
  • Zeitformat byte
  • Zeitformat (Millisekunden)
  • Zeitformatbeispiele

Die folgende Tabelle enthält die Flags, 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-Audio-Gerä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 bei der Wiedergabe eine beliebige Ausgabe, die das aktuelle Format unterstützt. Dies ist die Standardoption.
Datensatz zusammenstellen auf
Datensatz ausstellen
Im Assemblermodus werden alle Spuren gemäß der Definition des Geräts aufgezeichnet. Die meisten VCRs befinden sich standardmäßig im Assemblermodus.
Audio all off
Audio all on
Deaktiviert oder aktiviert die Audioausgabe. Videoüberlagerungsgeräte, der MCISEQ-Sequencer und das MCIWAVE Waveform-Audio-Gerät unterstützen dieses Flag nicht.
Audio ausgelassen
audio left on
Audio direkt ausgeschaltet
Audio direkt eingeschaltet
Deaktiviert oder aktiviert die Ausgabe an den linken oder rechten Audiokanal. Videoüberlagerungsgeräte, der MCISEQ-Sequencer und das MCIWAVE Waveform-Audio-Gerät unterstützen dieses Flag nicht.
bitspersample bit_count Legt die Anzahl der Bits pro pcm -Beispiel (Pulse Code Pulse) fest, das wiedergegeben oder aufgezeichnet wird. Die Datei wird in diesem Format gespeichert.
bytespersec byte_rate Legt die durchschnittliche Anzahl der wiedergegebenen oder aufgezeichneten 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 die Uhrzeit fest. Das Format wird als lange ganze Zahl ohne Vorzeichen angegeben.
Indikatorformat Legen Sie das Zeitformat für den Zähler so fest, wie es vom Status "Counter" zurückgegeben wird. Informationen zu anwendbaren Typen finden Sie im Befehl "Zeitformat festlegen".
Zählerwert Legt den VCR-Indikator auf den angegebenen Wert fest. Der Wert muss im aktuellen Indikatorformat angegeben werden. Weitere Informationen finden Sie im Befehl set "counter format".
Tür geschlossen Entfernt die Taskleiste und schließt nach Möglichkeit die Tür. Bei VCRs lädt das Band automatisch.
Tür geöffnet Öffnet die Tür und wirft nach Möglichkeit die Leiste oder das Band aus.
Dateiformatformat Gibt ein Dateiformat an, das für Speicher- oder Erfassungsbefehle verwendet wird. 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 Dateiformate sind 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.
Tagtag formatieren Legt den Formattyp für die Wiedergabe und Aufzeichnung fest. Die Datei wird in diesem Format gespeichert.
Indexzeitcode
Indexzähler
Indexdatum
Indexzeit
Legt den aktuellen Anzeigebildschirm auf dem VCR fest.
Eingabe-Ganzzahl Legt den Audiokanal fest, der als Eingabe verwendet wird.
Längendauer Legt die vom Benutzer angegebene Länge des Bandes im VCR fest. Diese Länge wird durch den Statusbefehl "length" zurückgegeben und aus Kompatibilitäts- und Kompatibilitätsgelangen mit Anwendungen bereitgestellt, für die dieser Befehl eine gültige Länge zurückgeben muss.
master- Legt denSKRIPT-Sequencer als Synchronisierungsquelle fest. Synchronisierungsdaten werden im FORMAT DEST-Formats gesendet. Der MCISEQ-Sequencer unterstützt dieses Flag nicht.
master none Verhindert, dass derENDE-Sequencer Synchronisierungsdaten sendet. Der MCISEQ-Sequencer unterstützt dieses Flag nicht.
master smpte Legt denSKRIPT-Sequencer als Synchronisierungsquelle fest. Synchronisierungsdaten werden im SMPTE-Format (Society of Motion Picture and Tv Engineers) gesendet. Der MCISEQ-Sequencer unterstützt dieses Flag nicht.
Offsetzeit Legt die SMPTE-Offsetzeit fest. Der Offset ist die Anfangszeit einer SMPTE-basierten Sequenz. Die Zeit wird als hhausgedrückt: mm: ss: ff, wobei hh stunden, mm minuten, ss sekunden und ff Frames sind.
Ganzzahlige Ausgabe Legt den Audiokanal fest, der als Ausgabe verwendet wird.
Pausen-Timeout Legt die maximale Dauer eines Pausenbefehls in Millisekunden fest. Der Timeoutwert 0 (null) gibt an, dass kein Timeout auftritt.
Dauer des Postrolls Legt die Länge im aktuellen Zeitformat fest, die erforderlich ist, um den VCR-Transport zu unterbrechen, wenn ein Befehl zum Beenden oder Anhalten ausgegeben wird.
Portzuordnung Legt die MAPPer-Funktion für die DANN-Zuordnung als Port fest, der die DANN-Nachrichten empfängt. Dieser Befehl schlägt fehl, wenn die MAPPer-Datei oder ein port, den sie benötigt, von einer anderen Anwendung verwendet wird.
port none Deaktiviert das Senden vonBENACHRICHTIGUNG-Nachrichten. Mit diesem Befehl wird auch ein DANN-Port geschlossen.
Port port_number Legt den DANN-Port fest, der die FEHLERMELDUNG-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 die Ein- oder Ausschalten des Geräts fest.
Dauer der Vorabrolldauer Legt die Länge im aktuellen Zeitformat fest, die zum Stabilieren der VCR-Ausgabe erforderlich ist.
Datensatzformat SP
Datensatzformat LP
Datensatzformat EP
Legt den Aufzeichnungsmodus für den VCR auf SP für standard play, EP für erweiterte Wiedergabe oder LP für lange Wiedergabe fest. Diese Werte sind nicht als VHS-spezifisch gedacht. Sie sind drei geeigneten Modi mit anderen Bandformaten zuordnen. Sp wird z. B. der schnellsten Aufzeichnung mit der höchsten Qualität angezeigt.
samplespersec integer Legt die Abtastrate für Wiedergabe und Aufzeichnung fest. Die Datei wird in diesem Format gespeichert.
Suchen nach genau am
Genau aussuchen
Wählt einen von zwei Suchmodi aus. Bei "Genau suchen nach" wird seek immer zum angegebenen Frame bewegt. Bei "Genau suchen aus" wird seek zum nächstgelegenen Keyframe vor dem angegebenen Frame bewegt.
Slave-Datei Legt fest, dass der SEQUENCEr Dateidaten als Synchronisierungsquelle verwendet. Dies ist die Standardeinstellung.
slave slave slave Legt den SEQUENCEr für die Verwendung eingehenderSKRIPT-Daten für die Synchronisierungsquelle fest. Der Sequencer erkennt Synchronisierungsdaten im FORMAT DEST-Formats. Der MCISEQ-Sequencer unterstützt dieses Flag nicht.
Slave none Legt fest, dass der SEQUENCEr die Synchronisierung ignoriert.
Slave-Smpte Legt den SEQUENCEr für die Verwendung eingehenderSKRIPT-Daten für die Synchronisierungsquelle fest. Der Sequencer erkennt Synchronisierungsdaten im 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 Framerate als 1000 festgelegt ist. (Eine Rate von 500 ist halb normale Geschwindigkeit, 2000 ist doppelt normale Geschwindigkeit und so weiter.) Wenn Die Geschwindigkeit auf 0 (null) gesetzt wird, wird das Video so schnell wie möglich abspielt, ohne Frames und ohne Audio zu löschen.
Format des Dateiformats "still" Gibt das Dateiformat an, das für Erfassungsbefehle verwendet wird.
tempo tempo_value Legt das Tempo der Sequenz gemäß 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.
Bytes im Zeitformat In einem PCM-Dateiformat legt 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, setzen Frames voraus. Wenn das Gerät geöffnet wird, ist Frames der Standardmodus. Wird von Videodiscs im CAV-Format unterstützt.
Zeitformat hms Legt das Zeitformat auf Stunden, Minuten und Sekunden fest. Alle Befehle, die Positionswerte verwenden, setzen HMS voraus. HMS ist das Standardformat für CLV-Videodiscs. Geben Sie einen HMS-Wert als hh:mm:ss an, wobei hh stunden, mm minuten und ss Sekunden ist. Sie können ein Feld weglassen, wenn es und alle folgenden Felder 0 (null) sind. Beispielsweise sind 3, 3:0 und 3:0:0 alle gültige Möglichkeiten, drei 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" abkü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. Alle Befehle, die Positionswerte verwenden, setzen MSF voraus (das Standardformat für CD-Audio). Geben Sie einen MSF-Wert als mm:ss:ff an, wobei mm Minuten, ss Sekunden und ff Frames ist. Sie können ein Feld weglassen, wenn es und alle folgenden Felder 0 (null) sind. Beispielsweise sind 3, 3:0 und 3:0:0 gültige Möglichkeiten, 3 Minuten auszudrücken.
Die MSF-Felder haben die folgenden maximalen Werte:
  • Minuten 99
  • Sekunden 59
  • Frames 74
Zeitformatbeispiele Legt das Zeitformat auf Beispiele fest. Alle Positionsinformationen werden als Beispiele nach diesem Befehl angegeben.
Zeitformat smpte 24
Zeitformat smpte 25
Zeitformat smpte 30
Legt das Zeitformat auf eine SMPTE-Framerate fest. Legt für VCRs das Zeitformat auf hh:mm:ss:ff fest, wobei die rechtlichen Werte 00:00:00:00 bis 23:59:59:xx sind und xx eins kleiner als die Frames pro Sekunde ist, wie durch die Zahl 24, 25 oder 30 angegeben, wie im Flag angegeben. Bei der Eingabe werden 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. Alle Befehle, die Positionswerte verwenden, nehmen das SMPTE-Format an.
Die Sequenzdatei legt das Standardformat auf PPQN oder SMPTE fest.
Zeitformat smpte 30 drop Legt das Zeitformat auf SMPTE 30 Drop Frame Rate fest. Bei VCRs ist dies mit SMPTE 30 identisch, mit der Ausnahme, dass bestimmte Zeitcodepositionen aus dem Format gelöscht werden, damit die aufgezeichneten Zeitcodepositionen für jeden Frame (bei der NTSC-Framerate von 29,97 FPS) der Echtzeit (bei 30 Fps) entsprechen. Timecodepositionen, die verworfen werden, lauten wie folgt: zwei pro Minute für die ersten neun von zehn Minuten aufgezeichneten Inhalten. Um 01:04:59:29 wäre die nächste Timecodeposition beispielsweise 01:05:00:02 und nicht 01:05:00:00. Alle Befehle, die Positionswerte verwenden, nehmen das SMPTE-Format an.
Die Sequenzdatei legt das Standardformat auf PPQN oder SMPTE fest.
Musikzeiger im Zeitformat Legt das Zeitformat auf einen Songzeiger fest (16 Notizen). Alle Befehle, die Positionswerte verwenden, setzen Songzeigereinheiten voraus. 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, setzen TMSF voraus. Geben Sie einen TMSF-Wert als tt:mm:ss:ff an, wobei tt für tracks, mm für minutes, ss für seconds und ff für frames steht. Sie können ein Feld weglassen, wenn es und alle folgenden Felder 0 (null) sind. Beispielsweise sind 3, 3:0, 3:0:0 und 3:0:0:0 alle gültige Möglichkeiten zum Ausdrücken von Track 3.
Die TMSF-Felder haben die folgenden maximalen Werte:
  • Tracks 99
  • Minuten 90
  • Sekunden 59
  • Frames 74
Zeitformatspur Legt das Positionsformat auf Tracks fest. Alle Befehle, die Positionswerte verwenden, nehmen Spuren an.
Zeitmoduszähler Legt den Positionsinformationsmodus für die Verwendung der VCR-Leistungsindikatoren fest.
Erkennung im Zeitmodus Legt den Positionsinformationsmodus basierend auf der Erkennung von Zeitcodeinformationen auf dem Band fest. Wenn Zeitcodeinformationen erkannt werden, wird der Zeittyp auf "timecode" festgelegt. Andernfalls wird der Zeittyp auf "counter" festgelegt. "Detect" ist ein spezieller Modus. Wenn der Treiber geöffnet wird, ein neues Band eingefügt oder der Befehl "Zeitmodus" ausgegeben wird, überprüft der Treiber den auf dem Band verfügbaren aktuellen Zeitmodus und legt den "Zeittyp" entweder auf "Timecode" oder "Counter" fest. Sobald der "Zeittyp" festgelegt ist, ändert der Treiber ihn erst, wenn eine der oben genannten Bedingungen erneut auftritt.
Zeitmodus-Zeitcode Legt den Positionsinformationsmodus fest, um "Timecode"-Informationen auf dem Band zu verwenden.
Nachverfolgung plus
Nachverfolgungs-Minus
Zurücksetzen der Nachverfolgung
Passt die Geschwindigkeit des Videobandtransports in feinen Schritten an. Verwenden Sie die "Nachverfolgungsflags", wenn ein lautes Bild von einem VCR abgerufen wird. "Tracking plus" erhöht die Transportgeschwindigkeit. "Tracking minus" verringert die Transportgeschwindigkeit. "Tracking reset" gibt die Nachverfolgungsanpassung auf 0 (null) zurück.
Video aus Deaktiviert die Videoausgabe.
Video zu Aktiviert die Videoausgabe.

lpszFlags

Kann "wait", "notify" oder beides sein. Für DigitalVideo- und VCR-Geräte kann auch "Test" angegeben werden. Weitere Informationen zu diesen Flags finden Sie unter Die Warte-, Benachrichtigungs- und Testflags.

Rückgabewert

Gibt 0 (null) zurück, wenn der Fehler 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 innerhalb der Datei strukturiert sind und können nach Beginn der Aufzeichnung nicht mehr geändert werden. In der folgenden Liste werden diese Eigenschaften identifiziert:

  • Ausrichtung
  • bitspersample
  • bytespersec
  • channels
  • Formattag
  • samplespersec

Beispiele

Der folgende Befehl legt das Zeitformat auf Millisekunden und das Waveform-Audio-Format 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