Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
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 |