LINECALLSTATUS-Struktur (tapi.h)
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 |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
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 |