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
| Anforderung | Wert |
|---|---|
| Zielplattform | Windows |
| Kopfzeile | tapi.h |
| Bibliothek | Tapi32.lib |
| DLL | Tapi32.dll |