MCI _ SETAUDIO-Befehl
Der MCI _ SETAUDIO-Befehl legt Werte fest, die der Audiowiedergabe und -erfassung zugeordnet sind. DigitalVideo- und VCR-Geräte erkennen diesen Befehl.
Rufen Sie zum Senden dieses Befehls die mciSendCommand-Funktion mit den folgenden Parametern auf.
MCIERROR mciSendCommand(
MCIDEVICEID wDeviceID,
MCI_SETAUDIO,
DWORD dwFlags,
(DWORD) (LPMCI_GENERIC_PARMS) lpSetAudio
);
Parameter
-
wDeviceID
-
Gerätebezeichner des MCI-Geräts, das die Befehlsmeldung empfangen soll.
-
Dwflags
-
MCI _ NOTIFY, MCI _ WAIT oder MCI _ TEST. Informationen zu diesen Flags finden Sie unter Die Warte-, Benachrichtigungs- und Testflags.
-
lpSetAudio
-
Zeiger auf eine GENERISCHE _ MCI-PARMS-Struktur. _ (Geräte mit erweiterten Befehlssätzen können diese Struktur durch eine gerätespezifische Struktur ersetzen.)
Rückgabewert
Gibt 0 (null) zurück, wenn der Fehler erfolgreich war, oder andernfalls ein Fehler.
Bemerkungen
Die folgenden Flags gelten für den Digitalvideo-Gerätetyp:
-
MCI _ DGV _ SETAUDIO _ ALG
-
Der lpstrAlgorithm-Member der von lpSetAudio identifizierten Struktur enthält eine Adresse eines Puffers, der den Namen eines Audiokomprimierungsalgorithmus enthält. Der Komprimierungsalgorithmus wird von nachfolgenden MCI _ RESERVE- oder MCI _ RECORD-Befehlen verwendet. Die verfügbaren Algorithmen sind geräteabhängig. Wenn der Algorithmus nicht mit dem aktuellen Dateiformat kompatibel ist, wird das Dateiformat in das Standardformat für den Algorithmus geändert.
-
MCI _ DGV _ SETAUDIO _ CLOCKTIME
-
Die angegebene Zeit beträgt in Millisekunden und ist die absolute Zeit, wenn sie mit MCI _ DGV _ SETAUDIO OVER verwendet _ wird. (Dieses Mal ist nicht schrittweise mit der Wiedergabe des Arbeitsbereichs verbunden.)
-
MCI _ DGV _ SETAUDIO _ INPUT
-
Ändert das Kennzeichen für Denker, Treble oder Lautstärke, sodass es sich auf das Eingabesignal auswirkt und ändert, was aufgezeichnet wird. Wenn möglich, ist dies die Standardeinstellung beim Überwachen der Eingabe.
-
MCI _ DGV _ SETAUDIO _ ITEM
-
Eine Audiokonstante wird im dwItem-Member der durch lpSetAudio identifizierten Struktur angegeben. Die Konstante identifiziert den Wert, der festgelegt wird. Die folgenden Konstanten werden definiert:
-
MCI _ DGV _ SETAUDIO _ AVGBYTESPERSEC
-
Die durchschnittliche Anzahl von Bytes wird im dwValue-Member der durch lpSetAudio identifizierten Struktur angegeben. Dieser Wert legt die durchschnittliche Anzahl von Bytes pro Sekunde für die Wiedergabe oder Aufzeichnung im PCM-Format (Pulse Code Bytes) und im ADPCM-Format (Adaptive Differential Pulse Code Pulse) fest. Die Datei wird in diesem Format gespeichert.
-
MCI _ DGV _ SETAUDIO _ HEXADEZI
-
Die niedrige Audiofrequenzebene wird als Faktor im dwValue-Member der durch lpSetAudio identifizierten Struktur angegeben.
-
MCI _ DGV _ SETAUDIO _ BITSPERSAMPLE
-
Die Anzahl der Bits pro Stichprobe wird im dwValue-Member der durch lpSetAudio identifizierten Struktur angegeben. Dieser Wert legt die Anzahl der Bits pro wiedergegebener oder aufgezeichneter Stichprobe im PCM-Format fest. Die Datei wird in diesem Format gespeichert.
-
MCI _ DGV _ SETAUDIO _ BLOCKALIGN
-
Die Datenblockausrichtung wird im dwValue-Member der durch lpSetAudio identifizierten Struktur angegeben. Dieser Wert legt die Ausrichtung von Datenblöcken relativ zum Anfang der Eingabe von Wellenformdaten fest.
-
MCI _ DGV _ SETAUDIO _ SAMPLESPERSEC
-
Die Abtastrate wird im dwValue-Member der durch lpSetAudio identifizierten Struktur angegeben. Dieser Wert legt die Abtastrate für die Wiedergabe und Aufzeichnung mit den ALGORITHMEN PCM und ADPCM fest. Die Datei wird in diesem Format gespeichert.
-
MCI _ DGV _ SETAUDIO _ SOURCE
-
Eine Konstante, die die Quelle der Audioeingabe angibt, ist im dwValue-Member der struktur enthalten, die durch lpSetAudio identifiziert wird. Die folgenden Konstanten werden für die Audioeingabequellen definiert:
MCI _ DGV _ SETAUDIO _ SOURCE _ AVERAGE
Der Durchschnitt der linken und rechten Audiokanäle.
MCI _ DGV _ SETAUDIO _ SOURCE _ LEFT
Linker Audiokanal.
MCI _ DGV _ SETAUDIO _ SOURCE _ RIGHT
Richtiger Audiokanal.
MCI _ DGV _ SETAUDIO _ SOURCE _ STEREO
Stereo.
-
MCI _ DGV _ SETAUDIO _ STREAM
-
Ein Audiostream wird im dwValue-Member der durch lpSetAudio identifizierten Struktur angegeben. Der ganzzahlige Wert gibt den Audiostream an, der aus dem Arbeitsbereich wiedergegeben wird. Wenn der Stream nicht angegeben ist, wird der erste physisch verschachtelte Audiostream wiedergegeben.
-
MCI _ DGV _ SETAUDIO _ TREBLE
-
Die hochfrequente Audioebene wird als Faktor im dwValue-Member der durch lpSetAudio identifizierten Struktur angegeben.
-
MCI _ DGV _ SETAUDIO _ VOLUME
-
Die Audioebene für einen oder beide Audiokanäle wird als Faktor im dwValue-Member der struktur angegeben, die durch lpSetAudio identifiziert wird. Wenn das linke und das rechte Volume auf unterschiedliche Werte festgelegt wurden, ist das Verhältnis von volume von links nach rechts ungefähr unverändert.
-
MCI _ DGV _ SETAUDIO _ LEFT
-
Aktiviert den linken Audiokanal bei Verwendung mit MCI _ SET _ ON. Deaktiviert den linken Audiokanal bei Verwendung mit MCI _ SET _ OFF. Wenn dieses Flag mit der Kombination aus MCI _ DGV _ SETAUDIO _ VALUE und MCI _ DGV _ SETAUDIO VOLUME verwendet _ wird, wird die Lautstärke des linken Audiokanals festgelegt. Wenn dieses Flag mit MCI _ DGV _ SETAUDIO SOURCE verwendet _ wird, gibt es den linken Audiokanal als Quelle für den Audioeingabedigitalisierer an.
-
MCI _ DGV _ SETAUDIO _ OVER
-
Ein Parameter für die Übergangslänge ist im dwOver-Member der durch lpSetAudio identifizierten Struktur enthalten. Der Längenwert gibt an, wie lange (in Einheiten des aktuellen Zeitformats) es dauern soll, eine Änderung vorzunehmen, die einen Faktor verwendet. Wenn dieses Flag nicht verwendet wird, treten sofort Änderungen auf.
-
MCI _ DGV _ SETAUDIO _ QUALITY
-
Der lpstrQuality-Member der von lpSetAudio identifizierten Struktur enthält eine Adresse eines Puffers, der die Audioqualität definiert. Eine Textzeichenfolge innerhalb des Puffers gibt die Merkmale des Audiokomprimierungsalgorithmus an.
Das MCI _ DGV _ SETAUDIO _ ALG-Flag kann verwendet werden, um einen Qualitätsdeskriptor für den angegebenen Algorithmus auszuwählen. Wenn dieses Flag ausgelassen wird, wird der aktuelle Algorithmus verwendet.
Die verfügbaren Algorithmen und Deskriptornamen hängen vom Gerät ab. Jedes Gerät stellt Dokumentation für die verfügbaren Algorithmen und eine Beschreibung der entsprechenden Deskriptornamen bereit. Der MCI _ QUALITY-Befehl kann zusätzliche Deskriptornamen definieren.
-
MCI _ DGV _ SETAUDIO _ RECORD
-
Gibt an, ob die Aufzeichnung Audiodaten ein- oder ausschließt. In Kombination mit MCI _ SET _ ON werden Audiodaten aufgezeichnet. In Kombination mit MCI _ SET _ OFF werden Audiodaten ausgeschlossen. Die Standardeinstellung umfasst Audiodaten.
-
MCI _ DGV _ SETAUDIO _ RIGHT
-
Aktiviert den richtigen Audiokanal bei Verwendung mit MCI _ SET _ ON. Deaktiviert den richtigen Audiokanal bei Verwendung mit MCI _ SET _ OFF. Wenn dieses Flag mit der Kombination aus MCI _ DGV _ SETAUDIO _ VALUE und MCI _ DGV _ SETAUDIO VOLUME verwendet _ wird, wird die Lautstärke des richtigen Audiokanals festgelegt.
-
MCI _ DGV _ SETAUDIO-WERT _
-
Ein Wert wird im dwValue-Member der durch lpSetAudio identifizierten Struktur angegeben. Die Bedeutung des Werts wird durch die Konstante angegeben, die für das MCI _ DGV _ SETAUDIO _ ITEM-Flag definiert ist.
-
MCI _ SET _ OFF
-
Deaktiviert den angegebenen Audiokanal.
-
MCI _ SET _ ON
-
Aktiviert den angegebenen Audiokanal.
-
MCI _ _ SETAUDIO-AUSGABE
-
Ändert das Kennzeichen für Denker, Treble oder Lautstärke, sodass nur das wiedergegebene Signal und nicht das aufgezeichnete Geändert wird. Wenn möglich, ist dies die Standardeinstellung beim Überwachen der Eingabe.
Bei Digitalvideogeräten verweist der lpSetAudio-Parameter auf eine _ MCI-DGV _ SETAUDIO _ PARMS-Struktur.
Die folgenden zusätzlichen Flags werden mit dem Vcr-Gerätetyp verwendet:
-
MCI _ VCR _ SETAUDIO _ RECORD
-
Legt die Audioaufzeichnung auf ein oder aus fest, die in Verbindung mit einem der folgenden Flags verwendet wird:
MCI _ SET _ ON
Audioaufzeichnung ein.
MCI _ SET _ OFF
Audioaufzeichnung deaktiviert. Es kann erforderlich sein, zuerst die Assembleraufzeichnung zu deaktivieren (mithilfe des MCI _ SET-Befehls mit dem MCI _ VCR SET ASSEMBLE _ _ _ RECORD-Flag, das auf "Off" festgelegt ist), bevor die Audioaufzeichnung deaktiviert werden kann.
MCI _ TRACK
Der dwTrack-Member der von lpSetAudio identifizierten Struktur gibt an, welche Spur vom Befehl betroffen ist.
MCI _ VCR _ SETAUDIO _ SOURCE
Legt die Audioquelle fest. Dieses Flag muss mit dem MCI _ VCR _ SETAUDIO _ TO-Flag verwendet werden.
MCI _ VCR _ SETAUDIO _ MONITOR
Legt den Audioquellenmonitor fest. Dieses Flag muss mit dem MCI _ VCR _ SETAUDIO _ TO-Flag verwendet werden.
MCI _ VCR _ SETAUDIO _ TO
Der dwTo-Member der von lpSetAudio identifizierten Struktur enthält eine Konstante, die den Typ der Eingabe oder überwachten Eingabe beschreibt. Dies muss einer der folgenden Sein:
-
MCI _ VCR _ SRC _ TYPE _ TUNER
Typ: Tuner
-
MCI _ VCR _ SRC _ TYPE _ LINE
Typ: Zeile.
-
MCI _ VCR _ SRC _ TYPE _ AUX
Der Typ ist ein Hilfstyp.
-
MCI _ VCR _ SRC _ TYPE _ GENERIC
Der Typ ist generisch.
-
MCI _ VCR _ SRC _ TYPE _ MUTE
Typ: Stummschaltung. Dies kann nur mit dem MCI _ VCR _ SETAUDIO _ SOURCE-Flag verwendet werden.
-
AUSGABE DES _ MCI-VCR-SRC-TYPS _ _ _
Der Typ ist "output".
-
MCI _ VCR _ SETAUDIO _ NUMBER
Der dwNumber-Member der von lpSetAudio identifizierten Struktur enthält die zu verwendende Audioeingabe (des im dwTo-Member angegebenen Typs).
-
Bei VCR-Geräten zeigt der lpSetAudio-Parameter auf eine MCI _ VCR _ SETAUDIO _ PARMS-Struktur.
Requirements (Anforderungen)
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) |
Windows 2000 Professional [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) |
Windows 2000 Server [nur Desktop-Apps] |
| Header |
|