Struttura LINECALLSTATUS (tapi.h)
La struttura LINECALLSTATUS descrive lo stato corrente di una chiamata. Le informazioni contenute in questa struttura dipendono dalle funzionalità del dispositivo dell'indirizzo, dalla proprietà della chiamata da parte dell'applicazione chiamante e dallo stato corrente della chiamata sottoposta a query. Le funzioni lineGetCallStatus e TSPI_lineGetCallStatus restituiscono la struttura LINECALLSTATUS .
Sintassi
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;
Members
dwTotalSize
Dimensioni totali allocate a questa struttura di dati, in byte.
dwNeededSize
Dimensioni per questa struttura di dati necessaria per contenere tutte le informazioni restituite, in byte.
dwUsedSize
Dimensioni della parte di questa struttura di dati che contiene informazioni utili, in byte.
dwCallState
Stato di chiamata corrente della chiamata utilizzando una delle costanti LINECALLSTATE_.
dwCallStateMode
L'interpretazione del membro dwCallStateMode dipende dallo stato della chiamata. In molti casi, il valore sarà zero. La tabella seguente illustra i tipi dwCallStateMode per un determinato valore dwCallState .
| dwCallState | Significato |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
dwCallPrivilege
Privilegio dell'applicazione per questa chiamata. Questo membro utilizza una o più costanti LINECALLPRIVILEGE_.
dwCallFeatures
Flag che indicano le funzioni api di telefonia che possono essere richiamate sulla chiamata, data la disponibilità della funzionalità nelle funzionalità del dispositivo, lo stato di chiamata corrente e la proprietà della chiamata dell'applicazione chiamante. Zero indica che la funzionalità corrispondente non può essere richiamata dall'applicazione sullo stato corrente della chiamata; una indica che è possibile richiamare la funzionalità. Questo membro usa costanti LINECALLFEATURE_.
dwDevSpecificSize
Dimensioni del campo specifico del dispositivo, in byte.
dwDevSpecificOffset
Offset dall'inizio della struttura al campo specifico del dispositivo di dimensioni variabili. Le dimensioni del campo vengono specificate da dwDevSpecificOffset.
dwCallFeatures2
Indica che è possibile richiamare funzioni aggiuntive sulla chiamata, data la disponibilità della funzionalità nelle funzionalità del dispositivo, lo stato della chiamata corrente e la proprietà della chiamata dell'applicazione. Estensione del membro dwCallFeatures . Questo membro usa costanti LINECALLFEATURE2_.
tStateEntryTime
Coordinated Universal Time in corrispondenza del quale è stato immesso lo stato della chiamata corrente.
tStateEntryTime[8]
Coordinated Universal Time in corrispondenza del quale è stato immesso lo stato della chiamata corrente.
Commenti
Le estensioni specifiche del dispositivo devono usare l'area di dimensioni variabili DevSpecific (dwDevSpecificSize e dwDevSpecificOffset) di questa struttura di dati.
L'applicazione viene inviato un messaggio LINE_CALLSTATE ogni volta che cambia lo stato della chiamata di una chiamata. Questo messaggio fornisce solo il nuovo stato di chiamata della chiamata. Lo stato aggiuntivo relativo a una chiamata è disponibile con lineGetCallStatus.
I membri dwCallFeatures2 e tStateEntryTime sono disponibili solo per le applicazioni che aprono il dispositivo line con una versione API 2.0 o successiva.
Requisiti
| Requisito | Valore |
|---|---|
| Intestazione | tapi.h |