Estrutura LINECALLSTATUS (tapi.h)

Artigo
08/26/2023

A estrutura LINECALLSTATUS descreve o status atual de uma chamada. As informações nessa estrutura dependem dos recursos do dispositivo do endereço, da propriedade da chamada pelo aplicativo invocado e do estado atual da chamada que está sendo consultada. As funções lineGetCallStatus e TSPI_lineGetCallStatus retornam a estrutura LINECALLSTATUS .

Sintaxe

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;

Membros

dwTotalSize

Tamanho total alocado para essa estrutura de dados, em bytes.

dwNeededSize

Tamanho para essa estrutura de dados necessária para armazenar todas as informações retornadas, em bytes.

dwUsedSize

Tamanho da parte dessa estrutura de dados que contém informações úteis, em bytes.

dwCallState

Estado de chamada atual da chamada usando uma das constantes LINECALLSTATE_.

dwCallStateMode

A interpretação do membro dwCallStateMode é dependente de estado de chamada. Em muitos casos, o valor será zero. A tabela a seguir mostra os tipos dwCallStateMode para um determinado valor dwCallState .

dwCallState	Significado
LINECALLSTATE_BUSY	Constantes LINEBUSYMODE_
LINECALLSTATE_CONNECTED	Constantes LINECONNECTEDMODE_
LINECALLSTATE_DIALTONE	Constantes LINEDIALTONEMODE_
LINECALLSTATE_DISCONNECTED	Constantes LINEDISCONNECTMODE_
LINECALLSTATE_OFFERING	Constantes LINEOFFERINGMODE_
LINECALLSTATE_SPECIALINFO	Constantes LINESPECIALINFO_

dwCallPrivilege

Privilégio do aplicativo para essa chamada. Esse membro usa uma ou mais das constantes LINECALLPRIVILEGE_.

dwCallFeatures

Sinalizadores que indicam as funções da API de Telefonia que podem ser invocadas na chamada, dada a disponibilidade do recurso nos recursos do dispositivo, o estado de chamada atual e a propriedade de chamada do aplicativo invocador. Um zero indica que o recurso correspondente não pode ser invocado pelo aplicativo na chamada em seu estado atual; um indica que o recurso pode ser invocado. Esse membro usa constantes LINECALLFEATURE_.

dwDevSpecificSize

Tamanho do campo específico do dispositivo, em bytes.

dwDevSpecificOffset

Deslocamento do início da estrutura para o campo específico do dispositivo de tamanho variável. O tamanho do campo é especificado por dwDevSpecificOffset.

dwCallFeatures2

Indica que funções adicionais podem ser invocadas na chamada, dada a disponibilidade do recurso nos recursos do dispositivo, o estado de chamada atual e a propriedade da chamada do aplicativo invocado. Uma extensão do membro dwCallFeatures . Esse membro usa constantes LINECALLFEATURE2_.

tStateEntryTime

Tempo Universal Coordenado no qual o estado de chamada atual foi inserido.

tStateEntryTime[8]

Tempo Universal Coordenado no qual o estado de chamada atual foi inserido.

Comentários

As extensões específicas do dispositivo devem usar a área de tamanho variável DevSpecific (dwDevSpecificSize e dwDevSpecificOffset) dessa estrutura de dados.

O aplicativo recebe uma mensagem LINE_CALLSTATE sempre que o estado de chamada de uma chamada é alterado. Essa mensagem fornece apenas o novo estado de chamada da chamada. Outras status sobre uma chamada estão disponíveis com lineGetCallStatus.

Os membros dwCallFeatures2 e tStateEntryTime estão disponíveis apenas para aplicativos que abrem o dispositivo de linha com uma versão de API 2.0 ou posterior.