TSPI_phoneGetStatus-Funktion (tspi.h)
Die TSPI_phoneGetStatus-Funktion fragt das angegebene geöffnete Telefongerät nach dessen gesamter status ab.
Syntax
LONG TSPIAPI TSPI_phoneGetStatus(
HDRVPHONE hdPhone,
LPPHONESTATUS lpPhoneStatus
);
Parameter
hdPhone
Der Griff für das abzufragte Telefon.
lpPhoneStatus
Ein Zeiger auf eine variabel große Datenstruktur vom Typ PHONESTATUS, in die der Dienstanbieter Informationen zum status des Telefons schreibt. Vor dem Aufrufen TSPI_phoneGetStatus legt die Anwendung den dwTotalSize-Member dieser Struktur fest, um die Menge an Arbeitsspeicher anzugeben, die TAPI zum Zurückgeben von Informationen zur Verfügung steht.
Rückgabewert
Gibt null zurück, wenn die Funktion erfolgreich ist, oder eine Fehlernummer, wenn ein Fehler auftritt. Mögliche Rückgabewerte sind wie folgt:
PHONEERR_INVALPHONEHANDLE, PHONEERR_OPERATIONFAILED, PHONEERR_NOMEM, PHONEERR_OPERATIONUNAVAIL, PHONEERR_RESOURCEUNAVAIL.
Hinweise
Die folgende Tabelle gibt an, welche Member der PHONESTATUS-Datenstruktur von TAPI ausgefüllt und welche Member vom Dienstanbieter ausgefüllt werden. Der Dienstanbieter darf die von TAPI eingegebenen Werte nicht überschreiben.
| Mitglied | TAPI | Dienstanbieter |
|---|---|---|
| dwTotalSize; | X | |
| dwNeededSize; | X | |
| dwUsedSize; | X | |
| dwStatusFlags; | X | |
| dwNumOwners; | X | |
| dwNumMonitors; | X | |
| dwRingMode; | X | |
| dwRingVolume; | X | |
| dwHandsetHookSwitchMode; | X | |
| dwHandsetVolume; | X | |
| dwHandsetGain; | X | |
| dwSpeakerHookSwitchMode; | X | |
| dwSpeakerVolume; | X | |
| dwSpeakerGain; | X | |
| dwHeadsetHookSwitchMode; | X | |
| dwHeadsetVolume; | X | |
| dwHeadsetGain; | X | |
| dwDisplaySize; | X | |
| dwDisplayOffset; | X | |
| dwLampModesSize; | X | |
| dwLampModesOffset; | X | |
| dwOwnerNameSize; | X | |
| dwOwnerNameOffset; | X | |
| dwDevSpecificSize; | X | |
| dwDevSpecificOffset; | X |
TAPI kann diese Funktion verwenden, um den aktuellen Zustand eines geöffneten Telefongeräts zu bestimmen. Die status Informationen beschreibt Informationen über die Hookswitch-Geräte, klingeln, Lautstärke, Anzeige und Lampen des geöffneten Telefons.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Windows |
| Kopfzeile | tspi.h |