TSPI_phoneGetStatus-Funktion (tspi.h)

  • Artikel

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

Weitere Informationen

PHONESTATUS

PHONE_STATE