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

Weitere Informationen

PHONE_REPLY

Zusätzliche Telefondienstfunktionen

ÜBERSICHT ÜBER TAPI 2.2-Referenz