phoneSetGain-Funktion (tapi.h)
Die phoneSetGain-Funktion legt die Verstärkung des Mikrofons des angegebenen Hookswitch-Geräts auf die angegebene Verstärkungsstufe fest.
Syntax
LONG phoneSetGain(
HPHONE hPhone,
DWORD dwHookSwitchDev,
DWORD dwGain
);
Parameter
hPhone
Handle mit dem geöffneten Telefongerät. Die Anwendung muss der Besitzer des Telefons sein.
dwHookSwitchDev
Hookswitch-Gerät, dessen Mikrofonverstärkung festgelegt werden soll. Dieser Parameter verwendet nur eine der PHONEHOOKSWITCHDEV_ Konstanten.
dwGain
Zeiger auf eine DWORD-Instanz , die die neue Verstärkungseinstellung des Geräts enthält. Der dwGain-Parameter gibt die Verstärkungsebene des Hookswitch-Geräts an. Dies ist eine Zahl im Bereich 0x00000000 (Stille) bis 0x0000FFFF (maximale Lautstärke). Die tatsächliche Granularität und Quantisierung der Verstärkungseinstellungen in diesem Bereich sind dienstanbieterspezifisch. Ein Wert für dwGain , der außerhalb des Bereichs liegt, wird auf den nächstgelegenen Wert im Bereich festgelegt.
Rückgabewert
Gibt einen positiven Anforderungsbezeichner zurück, wenn die Funktion asynchron abgeschlossen wird, oder eine negative Fehlernummer, wenn ein Fehler auftritt. Der dwParam2-Parameter der entsprechenden PHONE_REPLY Meldung ist 0, wenn die Funktion erfolgreich ist, oder es ist eine negative Fehlernummer, wenn ein Fehler auftritt. Mögliche Rückgabewerte sind:
PHONEERR_INVALPHONEHANDLE, PHONEERR_NOMEM, PHONEERR_NOTOWNER, PHONEERR_RESOURCEUNAVAIL, PHONEERR_INVALPHONESTATE, PHONEERR_OPERATIONFAILED, PHONEERR_INVALHOOKSWITCHDEV, PHONEERR_UNINITIALIZED, PHONEERR_OPERATIONUNAVAIL.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Windows |
| Kopfzeile | tapi.h |
| Bibliothek | Tapi32.lib |
| DLL | Tapi32.dll |