LINECALLSTATUS-Struktur (tapi.h)

  • Artikel

Die LINECALLSTATUS-Struktur beschreibt die aktuelle status eines Aufrufs. Die Informationen in dieser Struktur hängen von den Gerätefunktionen der Adresse, dem Besitz des Aufrufs durch die aufrufende Anwendung und dem aktuellen Status des abgefragten Aufrufs ab. Die Funktionen lineGetCallStatus und TSPI_lineGetCallStatus geben die LINECALLSTATUS-Struktur zurück.

Syntax

typedef struct linecallstatus_tag {
  DWORD      dwTotalSize;
  DWORD      dwNeededSize;
  DWORD      dwUsedSize;
  DWORD      dwCallState;
  DWORD      dwCallStateMode;
  DWORD      dwCallPrivilege;
  DWORD      dwCallFeatures;
  DWORD      dwDevSpecificSize;
  DWORD      dwDevSpecificOffset;
  DWORD      dwCallFeatures2;
#if ...
  SYSTEMTIME tStateEntryTime;
#else
  WORD       tStateEntryTime[8];
#endif
} LINECALLSTATUS, *LPLINECALLSTATUS;

Member

dwTotalSize

Dieser Datenstruktur zugeordnete Gesamtgröße in Byte.

dwNeededSize

Größe für diese Datenstruktur, die benötigt wird, um alle zurückgegebenen Informationen in Bytes zu enthalten.

dwUsedSize

Größe des Teils dieser Datenstruktur, der nützliche Informationen in Byte enthält.

dwCallState

Aktueller Aufrufstatus des Aufrufs mithilfe einer der LINECALLSTATE_ Konstanten.

dwCallStateMode

Die Interpretation des dwCallStateMode-Members ist vom Aufrufzustand abhängig. In vielen Fällen ist der Wert null. Die folgende Tabelle zeigt dwCallStateMode-Typen für einen bestimmten dwCallState-Wert .

dwCallState Bedeutung
LINECALLSTATE_BUSY

LINEBUSYMODE_ Konstanten
LINECALLSTATE_CONNECTED

LINECONNECTEDMODE_ Konstanten
LINECALLSTATE_DIALTONE

LINEDIALTONEMODE_ Konstanten
LINECALLSTATE_DISCONNECTED

LINEDISCONNECTMODE_ Konstanten
LINECALLSTATE_OFFERING

LINEOFFERINGMODE_ Konstanten
LINECALLSTATE_SPECIALINFO

LINESPECIALINFO_ Konstanten

dwCallPrivilege

Die Berechtigung der Anwendung für diesen Aufruf. Dieser Member verwendet eine oder mehrere der LINECALLPRIVILEGE_ Konstanten.

dwCallFeatures

Flags, die die Telefonie-API-Funktionen angeben, die für den Aufruf aufgerufen werden können, wenn die Funktion in den Gerätefunktionen verfügbar ist, der aktuelle Anrufstatus und der Aufrufbesitz der aufrufenden Anwendung. Eine Null gibt an, dass das entsprechende Feature von der Anwendung im aktuellen Zustand des Aufrufs nicht aufgerufen werden kann. eine gibt an, dass das Feature aufgerufen werden kann. Dieser Member verwendet LINECALLFEATURE_ Konstanten.

dwDevSpecificSize

Größe des gerätespezifischen Felds in Bytes.

dwDevSpecificOffset

Offset vom Anfang der Struktur zum variabel dimensionierten gerätespezifischen Feld. Die Größe des Felds wird durch dwDevSpecificOffset angegeben.

dwCallFeatures2

Gibt an, dass zusätzliche Funktionen für den Aufruf aufgerufen werden können, wenn die Funktion in den Gerätefunktionen verfügbar ist, der aktuelle Aufrufstatus und der Aufrufbesitz der aufrufenden Anwendung. Eine Erweiterung des dwCallFeatures-Elements . Dieser Member verwendet LINECALLFEATURE2_ Konstanten.

tStateEntryTime

Koordinierte Weltzeit, zu der der aktuelle Aufrufzustand eingegeben wurde.

tStateEntryTime[8]

Koordinierte Weltzeit, zu der der aktuelle Aufrufzustand eingegeben wurde.

Hinweise

Gerätespezifische Erweiterungen sollten den DevSpecific-Bereich (dwDevSpecificSize und dwDevSpecificOffset) mit unterschiedlicher Größe dieser Datenstruktur verwenden.

Die Anwendung erhält eine LINE_CALLSTATE Nachricht, wenn sich der Anrufstatus eines Aufrufs ändert. Diese Meldung gibt nur den neuen Anrufstatus des Anrufs an. Weitere status zu einem Anruf sind mit lineGetCallStatus verfügbar.

Die Member dwCallFeatures2 und tStateEntryTime sind nur für Anwendungen verfügbar, die das Leitungsgerät mit einer API-Version von 2.0 oder höher öffnen.

Anforderungen

Anforderung Wert
Header tapi.h

Weitere Informationen

LINEDIALPARAMS

LINE_CALLSTATE

TSPI_lineGetCallStatus

lineGetCallStatus