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