TSPI_phoneSetHookSwitch-Funktion (tspi.h)
Die TSPI_phoneSetHookSwitch-Funktion legt den Hookstatus der hookswitch-Geräte des angegebenen geöffneten Telefons auf den angegebenen Modus fest. Nur der Hookswitchstatus der aufgeführten Hookswitch-Geräte ist betroffen.
Syntax
LONG TSPIAPI TSPI_phoneSetHookSwitch(
DRV_REQUESTID dwRequestID,
HDRVPHONE hdPhone,
DWORD dwHookSwitchDevs,
DWORD dwHookSwitchMode
);
Parameter
dwRequestID
Der Bezeichner der asynchronen Anforderung.
hdPhone
Das Handle für das Telefon, das die Hookswitch-Geräte enthält, deren Modi festgelegt werden sollen.
dwHookSwitchDevs
Die Geräte, deren Hookswitchmodus festgelegt werden soll. Dieser Parameter verwendet eine der PHONEHOOKSWITCHDEV_ Konstanten.
dwHookSwitchMode
Der festzulegende Hookswitchmodus. Dieser Parameter kann nur eine der PHONEHOOKSWITCHMODE_ Konstanten aufweisen.
Rückgabewert
Gibt dwRequestID oder eine Fehlernummer zurück, wenn ein Fehler auftritt. Der tatsächliche lResult-Parameter der entsprechenden ASYNC_COMPLETION ist null, wenn die Funktion erfolgreich ist, oder es ist eine Fehlernummer, wenn ein Fehler auftritt. Mögliche Rückgabewerte sind:
PHONEERR_INVALPHONEHANDLE, PHONEERR_NOMEM, PHONEERR_INVALHOOKSWITCHDEV, PHONEERR_RESOURCEUNAVAIL, PHONEERR_INVALHOOKSWITCHMODE, PHONEERR_OPERATIONFAILED, PHONEERR_INVALPHONESTATE, PHONEERR_OPERATIONUNAVAIL.
Hinweise
Der Hookswitch-Modus wird für alle angegebenen Geräte in die angegebene Einstellung geändert. Wenn unterschiedliche Einstellungen gewünscht sind, 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 | tspi.h |
Weitere Informationen
PHONEHOOKSWITCHDEV_ Konstanten