Befehl MCI_SETAUDIO

Der MCI_SETAUDIO Befehl legt Werte fest, die der Audiowiedergabe und -aufnahme 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 Befehlsnachricht empfängt.

Dwflags

MCI_NOTIFY, MCI_WAIT oder MCI_TEST. Informationen zu diesen Flags finden Sie unter "Warten", "Benachrichtigen" und "Test flags".

lpSetAudio

Zeiger auf eine MCI_GENERIC_PARMS Struktur. (Geräte mit erweiterten Befehlssätzen können diese Struktur durch eine gerätespezifische Struktur ersetzen.)

Rückgabewert

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

Bemerkungen

Die folgenden Kennzeichen gelten für den Digitalvideo-Gerätetyp :

MCI_DGV_SETAUDIO_ALG

Das lpstrAlgorithm-Element der struktur, die von lpSetAudio identifiziert wird, enthält eine Adresse eines Puffers, der den Namen eines Audiokomprimierungsalgorithmus enthält. Der Komprimierungsalgorithmus wird durch nachfolgende MCI_RESERVE oder MCI_RECORD Befehle verwendet. Die verfügbaren Algorithmen sind geräteabhängig. Wenn der Algorithmus mit dem aktuellen Dateiformat nicht kompatibel ist, wird das Dateiformat in das Standardformat für den Algorithmus geändert.

MCI_DGV_SETAUDIO_CLOCKTIME

Die angegebene Zeit befindet sich in Millisekunden und ist absolute Zeit, wenn sie mit MCI_DGV_SETAUDIO_OVER verwendet wird. (Dieses Mal ist nicht in Schritt mit der Wiedergabe des Arbeitsbereichs.)

MCI_DGV_SETAUDIO_INPUT

Ändert die Bass-, Treble- oder Lautstärkekennzeichnung so, dass es sich auf das Eingabesignal auswirkt und ändert, was aufgezeichnet wird. Wenn möglich, ist dies die Standardeinstellung bei der Überwachung der Eingabe.

MCI_DGV_SETAUDIO_ITEM

Eine Audiokonstante wird im dwItem-Element der struktur angegeben, die von lpSetAudio identifiziert wird. Die Konstante identifiziert den wert, der festgelegt wird. Die folgenden Konstanten sind definiert:

MCI_DGV_SETAUDIO_AVGBYTESPERSEC

Die durchschnittliche Anzahl von Bytes wird im dwValue-Element der struktur angegeben, die von lpSetAudio identifiziert wird. Dieser Wert legt die durchschnittliche Anzahl von Bytes pro Sekunde für die Wiedergabe oder Aufzeichnung in den FORMATen PCM (Pulse Code Modulation) und ADPCM (Adaptive Differential Pulse Code Modulation) fest. Die Datei wird in diesem Format gespeichert.

MCI_DGV_SETAUDIO_BASS

Der Audio-Niedrigfrequenzpegel wird als Faktor im dwValue-Element der struktur angegeben, die von lpSetAudio identifiziert wird.

MCI_DGV_SETAUDIO_BITSPERSAMPLE

Die Anzahl der Bits pro Beispiel wird im dwValue-Element der struktur angegeben, die von lpSetAudio identifiziert wird. Dieser Wert legt die Anzahl der Bits pro Beispiel fest, die im PCM-Format wiedergegeben oder aufgezeichnet werden. Die Datei wird in diesem Format gespeichert.

MCI_DGV_SETAUDIO_BLOCKALIGN

Die Ausrichtung des Datenblocks wird im dwValue-Element der struktur angegeben, die von lpSetAudio identifiziert wird. Dieser Wert legt die Ausrichtung von Datenblöcken relativ zum Anfang der Eingabewellenformdaten fest.

MCI_DGV_SETAUDIO_SAMPLESPERSEC

Die Stichprobenrate wird im dwValue-Element der struktur angegeben, die von lpSetAudio identifiziert wird. Dieser Wert legt die Samplerate für die Wiedergabe und Aufzeichnung mit den PCM- und ADPCM-Algorithmen fest. Die Datei wird in diesem Format gespeichert.

MCI_DGV_SETAUDIO_SOURCE

Eine Konstante, die die Quelle der Audioeingabe angibt, ist im dwValue-Element der struktur enthalten, die von lpSetAudio identifiziert wird. Die folgenden Konstanten werden für die Audioeingabequellen definiert:

MCI_DGV_SETAUDIO_SOURCE_AVERAGE

Der Mittelwert der linken und rechten Audiokanäle.

MCI_DGV_SETAUDIO_SOURCE_LEFT

Linker Audiokanal.

MCI_DGV_SETAUDIO_SOURCE_RIGHT

Rechter Audiokanal.

MCI_DGV_SETAUDIO_SOURCE_STEREO

Stereo.

MCI_DGV_SETAUDIO_STREAM

Ein Audiodatenstrom wird im dwValue-Element der struktur angegeben, die von lpSetAudio identifiziert wird. Der ganzzahlige Wert gibt den Audiodatenstrom an, der aus dem Arbeitsbereich wiedergegeben wird. Wenn der Datenstrom nicht angegeben ist, wird der erste physisch interleavierte Audiodatenstrom wiedergegeben.

MCI_DGV_SETAUDIO_TREBLE

Der Audio-High-Frequency-Level wird als Faktor im dwValue-Element der struktur angegeben, die von lpSetAudio identifiziert wird.

MCI_DGV_SETAUDIO_VOLUME

Die Audioebene für einen oder beide Audiokanäle wird als Faktor im dwValue-Element der struktur angegeben, die von lpSetAudio identifiziert wird. Wenn die linken und rechten Volumes auf unterschiedliche Werte festgelegt wurden, ist das Verhältnis von links nach rechts ungefähr unverändert.

MCI_DGV_SETAUDIO_LEFT

Aktiviert den linken Audiokanal, wenn er mit MCI_SET_ON verwendet wird. Deaktiviert den linken Audiokanal, wenn er mit MCI_SET_OFF verwendet wird. Wenn dieses Kennzeichen mit der Kombination von 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 Audioeingabe-Digitalisierer an.

MCI_DGV_SETAUDIO_OVER

Ein Übergangslängenparameter ist im dwOver-Element der struktur enthalten, die von lpSetAudio identifiziert wird. Der Längenwert gibt an, wie lange (in Einheiten des aktuellen Zeitformats) erforderlich ist, um eine Änderung vorzunehmen, die einen Faktor verwendet. Wenn dieses Kennzeichen nicht verwendet wird, treten Änderungen sofort auf.

MCI_DGV_SETAUDIO_QUALITY

Das lpstrQuality-Element der struktur, die von lpSetAudio identifiziert wird, 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 Kennzeichen nicht angegeben wird, wird der aktuelle Algorithmus verwendet.

Die verfügbaren Algorithmen und Deskriptornamen hängen vom Gerät ab. Jedes Gerät liefert Dokumentation für die verfügbaren Algorithmen und eine Beschreibung der anwendbaren Deskriptornamen. Der Befehl MCI_QUALITY kann zusätzliche Deskriptornamen definieren.

MCI_DGV_SETAUDIO_RECORD

Gibt an, ob die Aufzeichnung Audiodaten enthält oder ausschließt. In Kombination mit MCI_SET_ON werden Audiodaten aufgezeichnet. Bei Kombination mit MCI_SET_OFF werden Audiodaten ausgeschlossen. Der Standardwert enthält Audiodaten.

MCI_DGV_SETAUDIO_RIGHT

Aktiviert den richtigen Audiokanal, wenn er mit MCI_SET_ON verwendet wird. Deaktiviert den richtigen Audiokanal, wenn er mit MCI_SET_OFF verwendet wird. Wenn dieses Kennzeichen mit der Kombination von MCI_DGV_SETAUDIO_VALUE und MCI_DGV_SETAUDIO_VOLUME verwendet wird, wird die Lautstärke des richtigen Audiokanals festgelegt.

MCI_DGV_SETAUDIO_VALUE

Ein Wert wird im dwValue-Element der struktur angegeben, die von lpSetAudio identifiziert wird. Die Bedeutung des Werts wird durch die für das MCI_DGV_SETAUDIO_ITEM Flag definierte Konstante angegeben.

MCI_SET_OFF

Deaktiviert den angegebenen Audiokanal.

MCI_SET_ON

Aktiviert den angegebenen Audiokanal.

MCI_SETAUDIO_OUTPUT

Ändert die Bass-, Treble- oder Lautstärkeflagge so, dass es nur das wiedergegebene Signal ändert und nicht was aufgezeichnet wird. Wenn möglich, ist dies die Standardeinstellung bei der Überwachung der Eingabe.

Bei digital-video-Gerä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, die in Verbindung mit einem der folgenden Flags verwendet wird:

MCI_SET_ON

Audioaufzeichnung aktiviert.

MCI_SET_OFF

Audioaufzeichnung deaktiviert. Möglicherweise ist es erforderlich, zuerst die Assemble-Aufzeichnung zu deaktivieren (mithilfe des Befehls MCI_SET mit dem MCI_VCR_SET_ASSEMBLE_RECORD-Kennzeichen, das deaktiviert ist), bevor die Audioaufzeichnung deaktiviert werden kann.

MCI_TRACK

Das dwTrack-Element der struktur, die von lpSetAudio identifiziert wird, gibt an, welche Spur vom Befehl beeinflusst wird.

MCI_VCR_SETAUDIO_SOURCE

Legt die Audioquelle fest. Dieses Kennzeichen muss mit dem MCI_VCR_SETAUDIO_TO Flag verwendet werden.

MCI_VCR_SETAUDIO_MONITOR

Legt den Audioquellenmonitor fest. Dieses Kennzeichen muss mit dem MCI_VCR_SETAUDIO_TO Flag verwendet werden.

MCI_VCR_SETAUDIO_TO

Das dwTo-Element der struktur, die von lpSetAudio identifiziert wird, enthält eine Konstante, die den Typ der Eingabe oder überwachten Eingabe beschreibt. Es muss eine der folgenden Sein:

MCI_VCR_SRC_TYPE_TUNER

Typ ist Tuner.

MCI_VCR_SRC_TYPE_LINE

Der Typ ist Zeile.

MCI_VCR_SRC_TYPE_AUX

Der Typ ist Hilfstyp.

MCI_VCR_SRC_TYPE_GENERIC

Der Typ ist generisch.

MCI_VCR_SRC_TYPE_MUTE

Der Typ ist stummgeschaltet. Dies kann nur mit dem MCI_VCR_SETAUDIO_SOURCE Flag verwendet werden.

MCI_VCR_SRC_TYPE_OUTPUT

Der Typ ist Ausgabe.

MCI_VCR_SETAUDIO_NUMBER

Das dwNumber-Element der struktur, die von lpSetAudio identifiziert wird, enthält die audioeingabe (des typs, der im dwTo-Element angegeben ist), das verwendet werden soll.

Für VCR-Geräte verweist 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 (einschließen Windows.h)

Siehe auch

MCI

MCI-Befehle