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 |
|