Estrutura LINECALLSTATUS (tapi.h)
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 |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
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.
Requisitos
| Requisito | Valor |
|---|---|
| Cabeçalho | tapi.h |