phoneGetHookSwitch-Funktion (tapi.h)

Artikel
03/02/2024

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

Syntax

LONG phoneGetHookSwitch(
  HPHONE  hPhone,
  LPDWORD lpdwHookSwitchDevs
);

Parameter

hPhone

Handle zum geöffneten Telefongerät.

lpdwHookSwitchDevs

Zeiger auf ein DWORD , das mit dem Modus der Hookswitch-Geräte des Telefons gefüllt werden soll. Wenn eine Bitposition FALSE ist, ist das entsprechende Hookswitch-Gerät onhook; wenn TRUE, ist der Mikrofon- und/oder Lautsprecherteil des entsprechenden Hookswitch-Geräts offhook. Um herauszufinden, ob das Mikrofon und/oder der Lautsprecher aktiviert sind, kann die Anwendung phoneGetStatus verwenden. Dieser Parameter verwendet mindestens eine der PHONEHOOKSWITCHDEV_ Konstanten.

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_OPERATIONUNAVAIL, PHONEERR_UNINITIALIZED.

Hinweise

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