TSPI_phoneGetHookSwitch-Funktion (tspi.h)

Artikel
03/03/2024

Die TSPI_phoneGetHookSwitch-Funktion gibt den aktuellen Hookswitch-Modus des angegebenen geöffneten Telefongeräts zurück.

Syntax

LONG TSPIAPI TSPI_phoneGetHookSwitch(
  HDRVPHONE hdPhone,
  LPDWORD   lpdwHookSwitchDevs
);

Parameter

hdPhone

Das undurchsichtige Handle des Dienstanbieters für das Telefon, dessen Hookswitchmodus abgerufen werden soll.

lpdwHookSwitchDevs

Ein Zeiger auf einen DWORD-großen Standort, in den der Dienstanbieter den Modus der Hookswitch-Geräte des Telefons schreibt. Dieser Parameter verwendet eine der PHONEHOOKSWITCHDEV_ Konstanten. Wenn eine Bitposition FALSE ist, ist das entsprechende Hookswitch-Gerät onhook. Bei TRUE ist der Mikrofon- und/oder Lautsprecherteil des entsprechenden Hookswitch-Geräts offhook. Um herauszufinden, ob Mikrofon und/oder Lautsprecher aktiviert sind, kann TAPI TSPI_phoneGetStatus verwenden.

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_NOMEM, PHONEERR_OPERATIONUNAVAIL.

Hinweise

Nachdem sich der Hookswitch-Zustand eines Geräts geändert hat und wenn die Hookswitch-Überwachung aktiviert ist, wird TAPI eine PHONE_STATE-Nachricht gesendet.