setaudio-Befehl

Der Setaudio-Befehl legt Werte fest, die der Audiowiedergabe und -aufnahme zugeordnet sind. Digitalvideo- und Videorekordergerä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("setaudio %s %s %s"), 
  lpszDeviceID, 
  lpszAudio, 
  lpszFlags
); 

Parameter

lpszDeviceID

Bezeichner eines MCI-Geräts. Dieser Bezeichner oder Alias wird zugewiesen, wenn das Gerät geöffnet wird.

lpszAudio

Flag für Audiowiedergabe und -aufnahme. In der folgenden Tabelle sind Gerätetypen aufgeführt, die den Befehl setaudio und die von den einzelnen Typen verwendeten Flags erkennen.

Wert	Bedeutung	Bedeutung
digitalvideo	Algorithmusausrichtungan ganzzahligemBass zum FaktorBitsPersample zu bit_count BytesPersec zu ganzzahligerTaktzeiteingabe links auf dem linken Volume, um bei Ausgabe zu faktorieren	Über DauerQualitätsdeskriptorDatensatz aus Datensatz direkt auf dem rechten Volume, um Stichproben zu faktorierenPerseczu ganzzahligeQuelle zu Quellnamestream to numbertripleble to factor volume to factorvolume to factor
Vcr	off on monitor to typenumber recordoff record off track_number off	Datensatz auf Datensatzspur track_number auf quelle, umnummernnummerntracktrack_number off track track_number einzugeben

In der folgenden Tabelle sind die Flags aufgeführt, die im parameter lpszAudio angegeben werden können, und ihre Bedeutungen.

Wert	Bedeutung
Algorithmus	Wählt einen bestimmten Audiokomprimierungsalgorithmus für die Verwendung durch einen nachfolgenden Reserve- oder Datensatzbefehl aus. Die unterstützten Algorithmen sind gerätespezifisch. MCI definiert die Werte "g711", "g721", "g722", "g728", "pcm", "cdxa", "adpcm" und "adpcm4e" für den Algorithmus. Wenn ein Gerät die Algorithmusnamen "pcm", "cdxa" und "adpcm4e" unterstützt, halten sie sich an Standarddefinitionen. Der "cdxa"-Algorithmus wurde von der Sony Corporation definiert. Der "adpcm4e"-Algorithmus wurde von der Intel Corporation definiert. Die Werte "g711", "g721", "g722" und "g728" stellen Audioalgorithmen dar, die vom International Telegraph and Telephone Consultative Committee (CCITT) empfohlen werden. Wenn der angegebene Algorithmus mit dem aktuellen Dateiformat in Konflikt steht, wird das Dateiformat in das Standardformat für den Algorithmus geändert.
Ausrichtung auf ganze Zahlen	Legt die Ausrichtung von Datenblöcken relativ zum Beginn der Eingangssignalform-Audiodaten fest.
bass to factor	Legt den Audiopegel mit niedriger Frequenz fest.
bitspersample to bit_count	Legt die Anzahl der Bits pro aufgezeichneter Stichprobe fest. Die Datei wird in diesem Format gespeichert. Dieses Flag gilt nur für Geräte, die den "pcm"-Algorithmus unterstützen.
bytespersec zu integer	Legt die durchschnittliche Anzahl von Bytes pro Sekunde für die Aufzeichnung in den Algorithmen "pcm" und "adpcm" fest. Die Datei wird in diesem Format gespeichert.
clocktime	Gibt an, dass die im Flag "over" angegebene Zeit in Millisekunden liegt. Diese Zeit ist absolut und nicht im Schritt mit der Wiedergabe des Arbeitsbereichs.
input	Ändert das Flag "Bass", "Höhen" oder "Lautstärke", sodass es sich auf das Eingabesignal auswirkt und die Aufgezeichneten ändert. Wenn möglich, ist dies die Standardeinstellung bei der Überwachung der Eingabe.
links links ein	Aktiviert oder deaktiviert die Audioausgabe auf dem linken Kanal. Die Audiopräsentationsquelle kann die externe Eingabe oder der Arbeitsbereich sein. Der Standardwert ist "left on". Wenn nur ein Kanal vorhanden ist, wird dieser Kanal aktiviert oder deaktiviert.
Linke Lautstärke, um zu faktorieren	Legt die Audiolautstärke des linken Audiokanals fest. Wenn nur ein Kanal vorhanden ist, legt er die Lautstärke fest.
überwachen, um die Nummer einzugeben	Steuert, welche Quelleingabe an die VCR-Ausgabe übergeben wird, ohne die Auswahl der Aufzeichnungsquelle zu ändern. Der Typ kann "Ausgabe" oder eine der gültigen Eingabequellen sein. Wenn die Zahl nicht angegeben ist, wird die erste Eingabe dieses Typs ausgewählt.
off on	Aktiviert oder deaktiviert Audio. Die Audiopräsentationsquelle kann entweder die externe Eingabe oder der Arbeitsbereich sein. Dieser Befehl wirkt sich gleichzeitig auf die linken und rechten Audiokanäle aus. Der Standardwert ist setaudio "on".
output	Ändert das Flag "Bass", "Höhen" oder "Lautstärke", sodass nur das wiedergegebene Signal und nicht das aufgezeichnete Signal geändert wird. Wenn möglich, ist dies die Standardeinstellung bei der Überwachung einer Datei.
Dauer	Gibt an, wie lange es dauern soll, eine Änderung vorzunehmen, die eine Faktorvariable verwendet. Die Einheiten für die Dauer befinden sich im aktuellen Zeitformat. Änderungen erfolgen im Schritt mit der Wiedergabe des Arbeitsbereichs. Wenn das Spielen angehalten wird, wird auch die Änderung angehalten, bis das Spiel fortgesetzt wird. Wenn "over" nicht angegeben oder nicht unterstützt wird, erfolgt die Änderung sofort.
Qualitätsdeskriptor	Gibt die Merkmale der Audiokomprimierung an, die beim Aufzeichnen von Audio in einer Datei ausgeführt wird. Alle Geräte unterstützen die drei Deskriptoren "low", "medium" und "high". Der Standardwert ist gerätespezifisch. Wenn das Flag "Algorithmus" nicht angegeben wird, gilt die Anpassung "Qualität" für den aktuellen Algorithmus. Mit dem Qualitätsbefehl können zusätzliche Deskriptornamen definiert werden.
Datensatz aus	Löscht die Audioquellenauswahl, sodass mit dem Befehl zum nächsten Datensatz kein Audio aufgezeichnet wird.
Eintrag auf	Ermöglicht die Aufzeichnung von Audiodaten. Die Standardeinstellung besteht darin, Audiodaten aufzuzeichnen.
Record Track track_number off	Löscht die Audioquellenauswahl, sodass mit dem Befehl zum nächsten Datensatz kein Audio aufgezeichnet wird. "Track" ermöglicht die unabhängige Titelauswahl. Track 2 entspricht dem PCM-Track in Hi8. Wenn "track" nicht angegeben ist, wird der Standardwert 1 angenommen.
Track track_number auf aufzeichnen	Wählt die Audioquelle aus, die mit dem Befehl zum nächsten Datensatz aufgezeichnet werden soll. "Track" ermöglicht die unabhängige Titelauswahl. Track 2 entspricht dem PCM-Track in Hi8. Wenn "track" nicht angegeben ist, wird der Standardwert 1 angenommen.
direkt rechts ein	Aktiviert oder deaktiviert die Audioausgabe im rechten Kanal. Die Audiopräsentationsquelle kann die externe Eingabe oder der Arbeitsbereich sein. Der Standardwert ist "right on". Wenn nur ein Kanal vorhanden ist, hat dieses Flag keine Auswirkung.
Rechtes Volumen, um zu faktorieren	Legt die Audiolautstärke auf den richtigen Audiokanal fest. Wenn es nur einen Kanal gibt, hat dies keine Auswirkung.
samplespersec to integer	Legt die Abtastrate für die Aufzeichnung mit den Algorithmen "pcm" und "adpcm" fest. Die Datei wird in diesem Format gespeichert.
source to sourcename	Gibt die Quelle für den Audioeingabedigisierer an. Die für sourcename definierten Konstanten umfassen: "left", "right", "average" und "stereo". Die ersten drei geben die monophone Aufzeichnung nur mit der linken Eingabe, nur der rechten Eingabe und dem Durchschnitt der beiden Eingaben an.
Source to type number number	Wählt die Audioquelle aus, die auf dem Band aufgezeichnet werden soll. Der Typ muss "tuner", "line", "svideo", "aux", "generic" oder "stummschalten" sein.
Streamen zu Nummer	Gibt den aus dem Arbeitsbereich wiedergegebenen Audiodatenstrom an. Wenn der Stream nicht angegeben ist und das Dateiformat keine Standardeinstellung definiert, wird der verschachtelte Audiodatenstrom wiedergegeben, der zuerst physisch verwendet wird.
track track_number off	Deaktiviert eine einzelne Spur.
nachverfolgen track_number on	Aktiviert eine einzelne Spur.
Verdreifachung zum Faktor	Legt den Audio-Hochfrequenzpegel fest.
zu faktorde Lautstärke	Legt die durchschnittliche Audiolautstärke für beide Audiokanäle fest. Wenn das linke und das rechte Volume auf unterschiedliche Werte festgelegt wurden, ist das Verhältnis des Links-zu-Rechts-Volumes nahezu unverändert.

lpszFlags

Dies kann "Wait", "notify", "test" oder eine Kombination aus diesen sein. Weitere Informationen zu diesen Flags finden Sie unter Die Warte-, Benachrichtigungs- und Testflags.

Rückgabewert

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

Bemerkungen

Bei VcR-Geräten kann die Verwendung von setaudio mit einem Flag, das eine einzelne Spur deaktiviert ("track track_number off"), dazu führen, dass Ihre Anwendung eine status Meldung erhält, die angibt, dass der Befehl nicht ausgeführt werden konnte. Einige Videorekorder können nur Kombinationen von Strecken deaktivieren, nicht einzelne Spuren; beispielsweise die erste Audiospur und eine Videospur einer Videokassette. Verwenden Sie in diesem Fall einfach setaudio und setvideo , um die anderen Spuren, aus denen die Kombination besteht, weiterhin zu deaktivieren. Der Fahrer schaltet die Strecken aus, wenn er den Befehl erhält, die letzte Spur in der Kombination zu deaktivieren.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]

Weitere Informationen

MCI

MCI-Befehlszeichenfolgen

record

Reservieren

setvideo