phoneGetGain-Funktion (tapi.h)

Die phoneGetGain-Funktion gibt die Verstärkungseinstellung des Mikrofons des hookswitch-Geräts des angegebenen Telefons zurück.

Syntax

LONG phoneGetGain(
  HPHONE  hPhone,
  DWORD   dwHookSwitchDev,
  LPDWORD lpdwGain
);

Parameter

hPhone

Handle mit dem geöffneten Telefongerät.

dwHookSwitchDev

Hookswitch-Gerät, dessen Verstärkungsebene abgefragt wird. Für den dwHookSwitchDev-Parameter kann nur ein Bit festgelegt sein. Dieser Parameter verwendet nur eine der PHONEHOOKSWITCHDEV_ Konstanten.

lpdwGain

Zeiger auf eine DWORD-Instanz , die die aktuelle Verstärkungseinstellung der Hookswitch-Mikrofonkomponente enthält. Der dwGain-Parameter gibt die Volumeebene 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.

Rückgabewert

Gibt null zurück, wenn die Anforderung erfolgreich ist, oder eine negative Fehlernummer, wenn ein Fehler auftritt. Mögliche Rückgabewerte sind:

PHONEERR_INVALPHONEHANDLE, PHONEERR_NOMEM, PHONEERR_INVALPOINTER, PHONEERR_RESOURCEUNAVAIL, PHONEERR_INVALPHONESTATE, PHONEERR_OPERATIONFAILED, PHONEERR_INVALHOOKSWITCHDEV, PHONEERR_UNINITIALIZED, PHONEERR_OPERATIONUNAVAIL.

Anforderungen

Weitere Informationen

Zusätzliche Telefondienstfunktionen

ÜBERSICHT ÜBER TAPI 2.2-Referenz