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