Estrutura LINEDEVSTATUS (tapi.h)

Artigo
03/08/2023

A estrutura LINEDEVSTATUS descreve o status atual de um dispositivo de linha. A função lineGetLineDevStatus e a função TSPI_lineGetLineDevStatus retornam a estrutura LINEDEVSTATUS .

Sintaxe

typedef struct linedevstatus_tag {
  DWORD dwTotalSize;
  DWORD dwNeededSize;
  DWORD dwUsedSize;
  DWORD dwNumOpens;
  DWORD dwOpenMediaModes;
  DWORD dwNumActiveCalls;
  DWORD dwNumOnHoldCalls;
  DWORD dwNumOnHoldPendCalls;
  DWORD dwLineFeatures;
  DWORD dwNumCallCompletions;
  DWORD dwRingMode;
  DWORD dwSignalLevel;
  DWORD dwBatteryLevel;
  DWORD dwRoamMode;
  DWORD dwDevStatusFlags;
  DWORD dwTerminalModesSize;
  DWORD dwTerminalModesOffset;
  DWORD dwDevSpecificSize;
  DWORD dwDevSpecificOffset;
  DWORD dwAvailableMediaModes;
  DWORD dwAppInfoSize;
  DWORD dwAppInfoOffset;
} LINEDEVSTATUS, *LPLINEDEVSTATUS;

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.

dwNumOpens

O número de ativos é aberto no dispositivo de linha.

dwOpenMediaModes

Matriz de bits que indica para quais tipos de mídia o dispositivo de linha está aberto no momento.

dwNumActiveCalls

Número de chamadas na linha em estados de chamada diferentes de idle, onhold, onholdpendingtransfer e onholdpendingconference.

dwNumOnHoldCalls

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

dwNumOnHoldPendCalls

Número de chamadas na linha no estado onholdpendingtransfer ou onholdpendingconference .

dwLineFeatures

Funções relacionadas à linha que estão disponíveis atualmente nessa linha. Esse membro usa uma ou mais das constantes LINEFEATURE_.

dwNumCallCompletions

Número de solicitações de conclusão de chamada pendentes na linha.

dwRingMode

Modo de anel atual no dispositivo de linha.

dwSignalLevel

Nível de sinal atual da conexão na linha. Esse é um valor no intervalo 0x00000000 (sinal mais fraco) para 0x0000FFFF (sinal mais forte).

dwBatteryLevel

Nível de bateria atual do hardware do dispositivo de linha. Esse é um valor no intervalo 0x00000000 (bateria vazia) para 0x0000FFFF (bateria cheia).

dwRoamMode

Modo de roaming atual do dispositivo de linha. Esse membro usa uma das constantes LINEROAMMODE_.

dwDevStatusFlags

Sinalizadores que indicam status informações, como se o dispositivo está bloqueado. Ele consiste em um ou mais membros de constantes LINEDEVSTATUSFLAGS_.

dwTerminalModesSize

Tamanho do campo de dispositivo de tamanho variably que contém uma matriz de modos de terminal atuais, em bytes.

dwTerminalModesOffset

Deslocamento do início da estrutura para uma matriz de modos de terminal atuais, em bytes. Essa matriz é indexada por IDs de terminal, no intervalo de zero a dwNumTerminals menos um. Cada entrada na matriz especifica os modos de terminal atuais para o conjunto de terminais correspondente usando a função lineSetTerminal para essa linha. Cada entrada é um DWORD que especifica uma ou mais das constantes LINETERMMODE_. O tamanho da matriz é especificado por dwTerminalModesSize.

dwDevSpecificSize

Tamanho do campo específico do dispositivo de tamanho variavelmente, em bytes. Se as informações específicas do dispositivo forem um ponteiro para uma cadeia de caracteres, o tamanho deverá incluir o terminador nulo .

dwDevSpecificOffset

Deslocamento do início da estrutura para o campo específico do dispositivo, em bytes. O tamanho do campo é especificado por dwDevSpecificSize.

dwAvailableMediaModes

Indica os tipos de mídia que podem ser invocados em novas chamadas criadas neste dispositivo de linha, quando o membro dwLineFeatures indica que novas chamadas são possíveis. Se esse membro for zero, ele indicará que o provedor de serviços não sabe ou não pode indicar quais tipos de mídia estão disponíveis; nesse caso, qualquer um ou todos os tipos de mídia indicados no membro dwMediaModes em LINEDEVCAPS podem estar disponíveis.

dwAppInfoSize

Tamanho da matriz que identifica os aplicativos que têm a linha aberta, em bytes.

dwAppInfoOffset

Deslocamento do início da estrutura para uma matriz de estruturas LINEAPPINFO . O membro dwNumOpens indica o número de elementos na matriz. Cada elemento na matriz identifica um aplicativo que tem a linha aberta. O tamanho da matriz é especificado por dwAppInfoSize.

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.

Os membros dwAvailableMediaModes por meio de dwAppInfoOffset estão disponíveis apenas para aplicativos que abrem o dispositivo de linha com uma versão de API 2.0 ou posterior.