Struttura LINECALLSTATUS (tapi.h)

  • Articolo

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
LINECALLSTATE_BUSY

Costanti LINEBUSYMODE_
LINECALLSTATE_CONNECTED

Costanti LINECONNECTEDMODE_
LINECALLSTATE_DIALTONE

Costanti LINEDIALTONEMODE_
LINECALLSTATE_DISCONNECTED

Costanti LINEDISCONNECTMODE_
LINECALLSTATE_OFFERING

Costanti LINEOFFERINGMODE_
LINECALLSTATE_SPECIALINFO

Costanti LINESPECIALINFO_

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

Vedi anche

LINEDIALPARAMS

LINE_CALLSTATE

TSPI_lineGetCallStatus

lineGetCallStatus