Estrutura LINEADDRESSSTATUS (tapi.h)

Artigo
08/26/2023

A estrutura LINEADDRESSSTATUS descreve o status atual de um endereço. A função lineGetAddressStatus e a função TSPI_lineGetAddressStatus retornam a estrutura LINEADDRESSSTATUS .

Sintaxe

typedef struct lineaddressstatus_tag {
  DWORD dwTotalSize;
  DWORD dwNeededSize;
  DWORD dwUsedSize;
  DWORD dwNumInUse;
  DWORD dwNumActiveCalls;
  DWORD dwNumOnHoldCalls;
  DWORD dwNumOnHoldPendCalls;
  DWORD dwAddressFeatures;
  DWORD dwNumRingsNoAnswer;
  DWORD dwForwardNumEntries;
  DWORD dwForwardSize;
  DWORD dwForwardOffset;
  DWORD dwTerminalModesSize;
  DWORD dwTerminalModesOffset;
  DWORD dwDevSpecificSize;
  DWORD dwDevSpecificOffset;
} LINEADDRESSSTATUS, *LPLINEADDRESSSTATUS;

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.

dwNumInUse

Número de estações que estão usando o endereço no momento.

dwNumActiveCalls

Número de chamadas no endereço que estão em estados de chamada diferentes de idle, onhold, onholdpendingtransfer e onholdpendingconference.

dwNumOnHoldCalls

Número de chamadas no endereço no estado de retenção .

dwNumOnHoldPendCalls

Número de chamadas no endereço no estado onholdpendingtransfer ou onholdpendingconference .

dwAddressFeatures

Funções relacionadas ao endereço que podem ser invocadas no endereço em seu estado atual. Esse membro usa uma ou mais das constantes LINEADDRFEATURE_.

dwNumRingsNoAnswer

O número de anéis definidos para esse endereço antes de uma chamada sem resposta é considerado como nenhuma resposta.

dwForwardNumEntries

Número de entradas na matriz referida por dwForwardSize e dwForwardOffset.

dwForwardSize

Tamanho da matriz de informações de encaminhamento, em bytes.

dwForwardOffset

Deslocamento do início da estrutura para o campo de tamanho variável que descreve as informações de encaminhamento do endereço. Essas informações são uma matriz de elementos dwForwardNumEntries , do tipo LINEFORWARD. Os deslocamentos dos endereços na matriz são relativos ao início da estrutura LINEADDRESSSTATUS . Os deslocamentos dwCallerAddressOffset e dwDestAddressOffset no campo de tamanho variável do tipo LINEFORWARD apontado por dwForwardOffset são relativos ao início da estrutura de dados LINEADDRESSSTATUS (o contêiner "raiz"). O tamanho da matriz é especificado por dwForwardSize.

dwTerminalModesSize

Tamanho da matriz de modos de terminal, em bytes.

dwTerminalModesOffset

Deslocamento do início da estrutura para o campo de dispositivo de tamanho variável que contém uma matriz com entradas do tamanho DWORD, que usam uma ou mais das constantes LINETERMMODE_. Essa matriz é indexada por identificadores de terminal, no intervalo de zero a um a menos que dwNumTerminals. Cada entrada na matriz especifica os modos de terminal atuais para o conjunto de terminais correspondente com a função lineSetTerminal para esse endereço. O tamanho da matriz é especificado por dwTerminalModesSize.

dwDevSpecificSize

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

dwDevSpecificOffset

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

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.

Essa estrutura de dados é retornada pela função lineGetAddressStatus . Quando os itens nessa estrutura de dados são alterados como consequência das atividades no endereço, uma mensagem LINE_ADDRESSSTATE é enviada ao aplicativo. Um parâmetro para essa mensagem é o estado de endereço, uma das constantes LINEADDRESSSTATE_, que indica que o item status nesse registro foi alterado.