TSPI_phoneSetGain-Funktion (tspi.h)
Die TSPI_phoneSetGain-Funktion legt die Verstärkung des Mikrofons des angegebenen Hookswitch-Geräts auf die angegebene Verstärkungsstufe fest.
Syntax
LONG TSPIAPI TSPI_phoneSetGain(
DRV_REQUESTID dwRequestID,
HDRVPHONE hdPhone,
DWORD dwHookSwitchDev,
DWORD dwGain
);
Parameter
dwRequestID
Der Bezeichner der asynchronen Anforderung.
hdPhone
Der Handle für das Telefon, das das Hookswitch-Gerät enthält, dessen Verstärkung festgelegt werden soll.
dwHookSwitchDev
Das Hookswitch-Gerät, dessen Mikrofonverstärkung festgelegt werden soll. Dieser Parameter verwendet nur eine der PHONEHOOKSWITCHDEV_ Konstanten.
dwGain
Eine DWORD-Größe, die die gewünschte neue Verstärkungseinstellung des Geräts enthält. 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. Ein Wert für dwGain , der sich außerhalb des Bereichs befindet, wird von TAPI an den nächstgelegenen Wert im Bereich geklemmt.
Rückgabewert
Gibt dwRequestID oder eine Fehlernummer zurück, wenn ein Fehler auftritt. Der tatsächliche lResult-Parameter der entsprechenden ASYNC_COMPLETION ist 0, wenn die Funktion erfolgreich ist, oder es ist 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
| Anforderung | Wert |
|---|---|
| Zielplattform | Windows |
| Kopfzeile | tspi.h |