phoneSetHookSwitch-Funktion (tapi.h)

Die phoneSetHookSwitch-Funktion legt den Hookstatus der angegebenen hookswitch-Geräte des angegebenen geöffneten Telefons auf den angegebenen Modus fest. Nur der Hookswitch-Zustand der aufgeführten Hookswitch-Geräte ist betroffen.

Syntax

LONG phoneSetHookSwitch(
  HPHONE hPhone,
  DWORD  dwHookSwitchDevs,
  DWORD  dwHookSwitchMode
);

Parameter

hPhone

Handle mit dem geöffneten Telefongerät. Die Anwendung muss der Besitzer des Telefons sein.

dwHookSwitchDevs

Gerät, dessen Hookswitch-Modus festgelegt werden soll. Dieser Parameter verwendet nur eine der PHONEHOOKSWITCHDEV_ Konstanten.

PHONEHOOKSWITCHDEV_HANDSET

Der Telefonhörer.

PHONEHOOKSWITCHDEV_SPEAKER

Die Freisprecheinrichtung oder das Zusatzgerät des Telefons.

PHONEHOOKSWITCHDEV_HEADSET

Das Headset des Telefons.

dwHookSwitchMode

Hookswitch-Modus festzulegen. Dieser Parameter verwendet nur eine der PHONEHOOKSWITCHMODE_ Konstanten.

PHONEHOOKSWITCHMODE_ONHOOK

Mikrofon und Lautsprecher des Geräts sind beide onhook.

PHONEHOOKSWITCHMODE_MIC

Das Mikrofon des Geräts ist aktiv, der Lautsprecher stummgeschaltet.

PHONEHOOKSWITCHMODE_SPEAKER

Der Lautsprecher des Geräts ist aktiv, das Mikrofon stummgeschaltet.

PHONEHOOKSWITCHMODE_MICSPEAKER

Mikrofon und Lautsprecher des Geräts sind aktiv.

Rückgabewert

Gibt einen positiven Anforderungsbezeichner zurück, wenn die Funktion asynchron abgeschlossen wird, oder eine negative Fehlernummer, wenn ein Fehler auftritt. Der dwParam2-Parameter der entsprechenden PHONE_REPLY Meldung ist 0, wenn die Funktion erfolgreich ist, oder es ist eine negative Fehlernummer, wenn ein Fehler auftritt. Mögliche Rückgabewerte sind:

PHONEERR_INVALPHONEHANDLE, PHONEERR_OPERATIONUNAVAIL, PHONEERR_NOTOWNER, PHONEERR_NOMEM, PHONEERR_INVALHOOKSWITCHDEV, PHONEERR_RESOURCEUNAVAIL, PHONEERR_INVALHOOKSWITCHMODE, PHONEERR_OPERATIONFAILED, PHONEERR_INVALPHONESTATE, PHONEERR_UNINITIALIZED.

Hinweise

Der Hookswitch-Modus ist für alle angegebenen Geräte identisch. Wenn unterschiedliche Einstellungen gewünscht werden, kann diese Funktion mehrmals mit einem anderen Satz von Parametern aufgerufen werden. Eine PHONE_STATE Nachricht wird an die Anwendung gesendet, nachdem sich der Hookswitch-Zustand geändert hat.

Anforderungen

Anforderung	Wert
Zielplattform	Windows
Kopfzeile	tapi.h
Bibliothek	Tapi32.lib
DLL	Tapi32.dll

Weitere Informationen

PHONE_REPLY

PHONE_STATE

Zusätzliche Telefondienstfunktionen

ÜBERSICHT ÜBER TAPI 2.2-Referenz