TSPI_phoneGetGain-Funktion (tspi.h)
Die TSPI_phoneGetGain-Funktion gibt die Verstärkungseinstellung des Mikrofons des hookswitch-Geräts des angegebenen Telefons zurück.
Syntax
LONG TSPIAPI TSPI_phoneGetGain(
HDRVPHONE hdPhone,
DWORD dwHookSwitchDev,
LPDWORD lpdwGain
);
Parameter
hdPhone
Der Griff zum Telefon, dessen Gewinn abgerufen werden soll.
dwHookSwitchDev
Das Hookswitch-Gerät, dessen Verstärkungsebene abgefragt wird. Dieser Parameter kann nur eine der PHONEHOOKSWITCHDEV_ Konstanten sein.
lpdwGain
Ein Zeiger auf einen Speicherort im DWORD-Format, in den der Dienstanbieter die aktuelle Verstärkungseinstellung der Hookswitch-Mikrofonkomponente schreibt. Der dwGain-Gain-Parameter gibt die Volumeebene des Hookswitch-Geräts an. Dies ist eine Zahl im Bereich von 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 Funktion erfolgreich ist, oder eine Fehlernummer, wenn ein Fehler auftritt. Mögliche Rückgabewerte sind wie folgt:
PHONEERR_INVALPHONEHANDLE, PHONEERR_RESOURCEUNAVAIL, PHONEERR_INVALPHONESTATE, PHONEERR_OPERATIONFAILED, PHONEERR_INVALHOOKSWITCHDEV, PHONEERR_OPERATIONUNAVAIL, PHONEERR_NOMEM.
Anforderungen
| Zielplattform | Windows |
| Kopfzeile | tspi.h |