Estrutura LINEADDRESSCAPS (tapi.h)

Artigo
08/26/2023

A estrutura LINEADDRESSCAPS descreve os recursos de um endereço especificado. A função lineGetAddressCaps e a função TSPI_lineGetAddressCaps retornam a estrutura LINEADDRESSCAPS .

Sintaxe

typedef struct lineaddresscaps_tag {
  DWORD dwTotalSize;
  DWORD dwNeededSize;
  DWORD dwUsedSize;
  DWORD dwLineDeviceID;
  DWORD dwAddressSize;
  DWORD dwAddressOffset;
  DWORD dwDevSpecificSize;
  DWORD dwDevSpecificOffset;
  DWORD dwAddressSharing;
  DWORD dwAddressStates;
  DWORD dwCallInfoStates;
  DWORD dwCallerIDFlags;
  DWORD dwCalledIDFlags;
  DWORD dwConnectedIDFlags;
  DWORD dwRedirectionIDFlags;
  DWORD dwRedirectingIDFlags;
  DWORD dwCallStates;
  DWORD dwDialToneModes;
  DWORD dwBusyModes;
  DWORD dwSpecialInfo;
  DWORD dwDisconnectModes;
  DWORD dwMaxNumActiveCalls;
  DWORD dwMaxNumOnHoldCalls;
  DWORD dwMaxNumOnHoldPendingCalls;
  DWORD dwMaxNumConference;
  DWORD dwMaxNumTransConf;
  DWORD dwAddrCapFlags;
  DWORD dwCallFeatures;
  DWORD dwRemoveFromConfCaps;
  DWORD dwRemoveFromConfState;
  DWORD dwTransferModes;
  DWORD dwParkModes;
  DWORD dwForwardModes;
  DWORD dwMaxForwardEntries;
  DWORD dwMaxSpecificEntries;
  DWORD dwMinFwdNumRings;
  DWORD dwMaxFwdNumRings;
  DWORD dwMaxCallCompletions;
  DWORD dwCallCompletionConds;
  DWORD dwCallCompletionModes;
  DWORD dwNumCompletionMessages;
  DWORD dwCompletionMsgTextEntrySize;
  DWORD dwCompletionMsgTextSize;
  DWORD dwCompletionMsgTextOffset;
  DWORD dwAddressFeatures;
  DWORD dwPredictiveAutoTransferStates;
  DWORD dwNumCallTreatments;
  DWORD dwCallTreatmentListSize;
  DWORD dwCallTreatmentListOffset;
  DWORD dwDeviceClassesSize;
  DWORD dwDeviceClassesOffset;
  DWORD dwMaxCallDataSize;
  DWORD dwCallFeatures2;
  DWORD dwMaxNoAnswerTimeout;
  DWORD dwConnectedModes;
  DWORD dwOfferingModes;
  DWORD dwAvailableMediaModes;
} LINEADDRESSCAPS, *LPLINEADDRESSCAPS;

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.

dwLineDeviceID

Identificador de dispositivo do dispositivo de linha ao qual esse endereço está associado.

dwAddressSize

Tamanho do campo de endereço, em bytes.

dwAddressOffset

Deslocamento do início da estrutura para o campo de endereço de tamanho variável. O tamanho do campo é especificado por dwAddressSize.

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 dwDevSpecificSize.

dwAddressSharing

Modo de compartilhamento do endereço. Esse membro pode ser uma das constantes LINEADDRESSSHARING_.

dwAddressStates

Endereçar as alterações de estados para as quais o aplicativo pode ser notificado na mensagem LINE_ADDRESSSTATE. Esse membro usa uma ou mais das constantes LINEADDRESSSTATE_.

dwCallInfoStates

Chame elementos de informações que são significativos para todas as chamadas nesse endereço. Um aplicativo pode ser notificado sobre alterações em alguns desses estados em mensagens LINE_CALLINFO . Esse membro usa uma ou mais das constantes LINECALLINFOSTATE_.

dwCallerIDFlags

Tipos de informações de identificador de parte que podem ser fornecidos para chamadas nesse endereço. O chamador é o originador da sessão. Uma ou mais das constantes LINECALLPARTYID_.

dwCalledIDFlags

Tipos de informações de identificador de parte que podem ser fornecidos para chamadas nesse endereço. Aqui, "chamado" refere-se ao destino original. Uma ou mais das constantes LINECALLPARTYID_.

dwConnectedIDFlags

Tipos de informações de identificador de parte que podem ser fornecidos para chamadas nesse endereço. Uma ou mais das constantes LINECALLPARTYID_.

dwRedirectionIDFlags

Tipos de informações de identificador de parte que podem ser fornecidos para chamadas nesse endereço. Aqui, "redirecionamento" é o novo destino. Uma ou mais das constantes LINECALLPARTYID_.

dwRedirectingIDFlags

Tipos de informações de identificador de parte que podem ser fornecidos para chamadas nesse endereço. Aqui, "redirecionamento" é o endereço que invocou o redirecionamento. Uma ou mais das constantes LINECALLPARTYID_.

dwCallStates

Estados de chamada que podem ser relatados para chamadas nesse endereço. Esse membro usa uma ou mais das constantes LINECALLSTATE_.

dwDialToneModes

Modos de tom de discagem que podem ser relatados para chamadas feitas nesse endereço. Esse membro só será significativo se o estado de chamada dialtone puder ser relatado. Esse membro usa uma ou mais das constantes LINEDIALTONEMODE_.

dwBusyModes

Modos ocupados que podem ser relatados para chamadas feitas nesse endereço. Esse membro só será significativo se o estado de chamada ocupado puder ser relatado. Esse membro usa uma ou mais das constantes LINEBUSYMODE_.

dwSpecialInfo

Tipos de informações especiais que podem ser relatados para chamadas feitas nesse endereço. Esse membro só será significativo se o estado de chamada specialInfo puder ser relatado. Esse membro usa uma ou mais das constantes LINESPECIALINFO_.

dwDisconnectModes

Desconecte os modos que podem ser relatados para chamadas feitas nesse endereço. Esse membro só será significativo se o estado de chamada desconectado puder ser relatado. Esse membro usa uma ou mais das constantes LINEDISCONNECTMODE_.

dwMaxNumActiveCalls

Número máximo de aparências de chamada ativas que o endereço pode manipular. Esse número não inclui chamadas em espera ou chamadas em espera pendentes de transferência ou conferência.

dwMaxNumOnHoldCalls

Número máximo de aparições de chamada no endereço que pode estar em espera.

dwMaxNumOnHoldPendingCalls

Número máximo de aparições de chamada no endereço que podem estar em espera aguardando transferência ou conferência.

dwMaxNumConference

Número máximo de partes que podem ingressar em uma única chamada em conferência nesse endereço.

dwMaxNumTransConf

Número de partes (incluindo "self") que podem ser adicionadas em uma chamada em conferência iniciada como uma chamada de consulta genérica usando lineSetupTransfer.

dwAddrCapFlags

Sinalizadores de bits empacotados que descrevem uma variedade de funcionalidades de endereço. Esse membro usa uma ou mais das constantes LINEADDRCAPFLAGS_.

dwCallFeatures

Alternar recursos ou recursos disponíveis para todas as chamadas nesse endereço usando as Constantes LINECALLFEATURE_. Esse membro representa os recursos relacionados à chamada que podem estar disponíveis em um endereço (disponibilidade estática em vez de disponibilidade dinâmica). Invocar um recurso com suporte requer que a chamada esteja no estado adequado e que o dispositivo de linha subjacente seja aberto em um modo compatível. Um zero em uma posição de bit indica que o recurso correspondente nunca está disponível. Um indica que o recurso correspondente pode estar disponível se o aplicativo tiver os privilégios certos para a chamada e a chamada estiver no estado apropriado para que a operação seja significativa. Esse membro permite que um aplicativo descubra quais recursos de chamada podem ser (e quais nunca podem ser) compatíveis com o endereço.

dwRemoveFromConfCaps

Recursos do endereço para remover chamadas de uma chamada em conferência. Esse membro usa uma das constantes LINEREMOVEFROMCONF_.

dwRemoveFromConfState

Usa as constantes LINECALLSTATE_ para especificar o estado da chamada depois que ela foi removida de uma chamada em conferência.

dwTransferModes

Recursos do endereço para resolver solicitações de transferência. Esse membro usa uma das constantes LINETRANSFERMODE_.

dwParkModes

Diferentes modos de estacionamento de chamada disponíveis neste endereço. Esse membro usa uma das constantes LINEPARKMODE_.

dwForwardModes

Diferentes modos de encaminhamento disponíveis para esse endereço. Esse membro usa as constantes LINEFORWARDMODE_.

dwMaxForwardEntries

Número máximo de entradas que podem ser passadas para lineForward no parâmetro lpForwardList .

dwMaxSpecificEntries

Número máximo de entradas no parâmetro lpForwardList passado para lineForward que podem conter instruções de encaminhamento com base em uma ID de chamador específica (encaminhamento seletivo de chamadas). Esse membro será zero se não houver suporte para o encaminhamento de chamadas seletivas.

dwMinFwdNumRings

Número mínimo de anéis que podem ser definidos para determinar quando uma chamada é oficialmente considerada "sem resposta".

dwMaxFwdNumRings

Número máximo de anéis que podem ser definidos para determinar quando uma chamada é oficialmente considerada "sem resposta". Se esse número de anéis não puder ser definido, dwMinFwdNumRings e dwMaxNumRings serão iguais .

dwMaxCallCompletions

Número máximo de solicitações de conclusão de chamada simultâneas que podem ser pendentes neste dispositivo de linha. Zero implica que a conclusão da chamada não está disponível.

dwCallCompletionConds

Diferentes condições de chamada sob as quais a conclusão da chamada pode ser solicitada. Esse membro usa uma ou mais das constantes LINECALLCOMPLCOND_.

dwCallCompletionModes

Maneira como a chamada pode ser concluída. Esse membro usa uma das constantes LINECALLCOMPLMODE_.

dwNumCompletionMessages

Número de mensagens de conclusão de chamada que podem ser selecionadas ao usar a opção LINECALLCOMPLMODE_MESSAGE. Mensagens individuais são identificadas por valores no intervalo zero até um menor que dwNumCompletionMessages.

dwCompletionMsgTextEntrySize

Tamanho de cada uma das descrições de texto de conclusão de chamada especificadas por dwCompletionMsgTextSize e dwCompletionMsgTextOffset, em bytes.

dwCompletionMsgTextSize

Tamanho do texto de conclusão da chamada, em bytes.

dwCompletionMsgTextOffset

Deslocamento do início dessa estrutura de dados para o campo de tamanho variativo que contém texto descritivo sobre cada uma das mensagens de conclusão de chamada. Cada mensagem é dwCompletionMsgTextEntrySize bytes long. O formato de cadeia de caracteres dessas descrições textuais é indicado por dwStringFormat nas funcionalidades do dispositivo da linha. O tamanho do campo é especificado por dwCompletionMsgTextSize.

dwAddressFeatures

Recursos disponíveis para esse endereço usando as constantes LINEADDRFEATURE_. Invocar um recurso com suporte requer que o endereço esteja no estado adequado e que o dispositivo de linha subjacente seja aberto em um modo compatível. Um zero em uma posição de bit indica que o recurso correspondente nunca está disponível. Um indica que o recurso correspondente poderá estar disponível se o endereço estiver no estado apropriado para que a operação seja significativa. Esse membro permite que um aplicativo descubra quais recursos de endereço podem ser (e quais nunca podem ser) compatíveis com o endereço.

dwPredictiveAutoTransferStates

Estado de chamada ou estados nos quais uma chamada feita por um discador preditivo pode ser definida para transferir automaticamente a chamada para outro endereço; uma ou mais constantes LINECALLSTATE_. O valor 0 indica que a transferência automática com base no estado de chamada não está disponível.

dwNumCallTreatments

Número de entradas na matriz de estruturas LINECALLTREATMENTENTRY delimitadas por dwCallTreatmentListSize e dwCallTreatmentListOffset.

dwCallTreatmentListSize

Tamanho da matriz de tratamento de chamada, em bytes.

dwCallTreatmentListOffset

Deslocamento do início da estrutura para uma matriz de estruturas LINECALLTREATMENTENTRY , especifique os tratamentos de chamada com suporte no endereço (que podem ser selecionados usando lineSetCallTreatment). O valor é dwNumCallTreatments times SIZEOF(LINECALLTREATMENTENTRY). O tamanho do campo é especificado por dwCallTreatmentListSize.

dwDeviceClassesSize

Tamanho da lista de classes de dispositivo com suporte, em bytes.

dwDeviceClassesOffset

Deslocamento do início da estrutura para uma cadeia de caracteres que consiste nos identificadores de classe de dispositivo com suporte nesse endereço para uso com lineGetID. Os elementos são separados por caracteres nulos e o último identificador de classe é seguido por dois caracteres nulos . O tamanho do campo é especificado por dwDeviceClassesSize.

dwMaxCallDataSize

Número máximo de bytes que um aplicativo pode definir em LINECALLINFO usando lineSetCallData.

dwCallFeatures2

Recursos adicionais de alternância ou recursos disponíveis para todas as chamadas nesse endereço usando as Constantes LINECALLFEATURE2_. É uma extensão do membro dwCallFeatures .

dwMaxNoAnswerTimeout

Valor máximo em segundos que pode ser definido no membro dwNoAnswerTimeout em LINECALLPARAMS ao fazer uma chamada. Um valor 0 indica que o abandono automático de chamadas sem resposta não é compatível com o provedor de serviços ou que o valor de tempo limite não é ajustável pelos aplicativos.

dwConnectedModes

LINECONNECTEDMODE_ valores que podem aparecer no membro dwCallStateMode de LINECALLSTATUS e em mensagens LINE_CALLSTATE para chamadas nesse endereço.

dwOfferingModes

LINEOFFERINGMODE_ valores que podem aparecer no membro dwCallStateMode de LINECALLSTATUS e em mensagens LINE_CALLSTATE para chamadas nesse endereço.

dwAvailableMediaModes

Tipos de mídia (modos) que podem ser invocados em novas chamadas criadas nesse endereço, quando o membro dwAddressFeatures 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.

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.

Aplicativos mais antigos são compilados sem esse membro na estrutura LINEADDRESSCAPS e usando um SIZEOF(LINEADDRESSCAPS) menor que o novo tamanho. O aplicativo passa um parâmetro dwAPIVersion com a função lineGetAddressCaps , que pode ser usada para orientação do TAPI para lidar com essa situação. Se o aplicativo passar um membro dwTotalSize menor que o tamanho da parte fixa da estrutura, conforme definido no membro dwAPIVersion especificado, LINEERR_STRUCTURETOOSMALL será retornado. Se a memória suficiente tiver sido alocada pelo aplicativo, antes de chamar TSPI_lineGetAddressCaps, TAPI definirá os membros dwNeedEdSize e dwUsedSize como o tamanho fixo da estrutura como ela existia na versão da API especificada.

Novos provedores de serviço (que dão suporte à nova versão da API) devem examinar a versão da API passada. Se a versão da API for menor do que a versão mais alta com suporte do provedor, o provedor de serviços não deverá preencher campos sem suporte em versões de API mais antigas, pois elas cairiam na parte variável da estrutura mais antiga.

Novos aplicativos devem estar cientes da versão da API negociada e não examinar o conteúdo dos campos na parte fixa além do final original da parte fixa da estrutura para a versão da API negociada.

Os membros dwPredictiveAutoTransferStates por meio de dwAvailableMediaModes estão disponíveis apenas para aplicativos que solicitam uma versão da API 2.0 ou posterior ao chamar lineGetAddressCaps.