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 |