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
Mmsystem.h (include Windows.h)

Weitere Informationen

MCI

MCI-Befehle