LINECALLINFO

Artigo
09/19/2008

Windows Mobile Supported Windows Embedded CE Supported

9/19/2008

Essa estrutura contém dados chamar. Este dados permanece fixos durante a chamar e são obtidos com o lineGetCallInfo função. If a part of the structure does change, then a LINE_CALLINFO mensagem é enviada para o aplicativo indicando que item de dados foi alterado. É dinamicamente alterar dados chamar, such as chamar andamento status, disponível na LINECALLSTATUS estrutura, retornada com o lineGetCallStatus função.

Syntax

typedef struct linecallinfo_tag {
  DWORD dwTotalSize;
  DWORD dwNeededSize;
  DWORD dwUsedSize;
  HLINE hLine;
  DWORD dwLineDeviceID;
  DWORD dwAddressID;
  DWORD dwBearerMode;
  DWORD dwRate;
  DWORD dwMediaMode;
  DWORD dwAppSpecific;
  DWORD dwCallID;
  DWORD dwRelatedCallID;
  DWORD dwCallParamFlags;
  DWORD dwCallStates;
  DWORD dwMonitorDigitModes;
  DWORD dwMonitorMediaModes;
  LINEDIALPARAMS DialParams;
  DWORD dwOrigin;
  DWORD dwReason;
  DWORD dwCompletionID;
  DWORD dwNumOwners;
  DWORD dwNumMonitors;
  DWORD dwCountryCode;
  DWORD dwTrunk;
  DWORD dwCallerIDFlags;
  DWORD dwCallerIDSize;
  DWORD dwCallerIDOffset;
  DWORD dwCallerIDNameSize;
  DWORD dwCallerIDNameOffset;
  DWORD dwCalledIDFlags;
  DWORD dwCalledIDSize;
  DWORD dwCalledIDOffset;
  DWORD dwCalledIDNameSize;
  DWORD dwCalledIDNameOffset;
  DWORD dwConnectedIDFlags;
  DWORD dwConnectedIDSize;
  DWORD dwConnectedIDOffset;
  DWORD dwConnectedIDNameSize;
  DWORD dwConnectedIDNameOffset;
  DWORD dwRedirectionIDFlags;
  DWORD dwRedirectionIDSize;
  DWORD dwRedirectionIDOffset;
  DWORD dwRedirectionIDNameSize;
  DWORD dwRedirectionIDNameOffset;
  DWORD dwRedirectingIDFlags;
  DWORD dwRedirectingIDSize;
  DWORD dwRedirectingIDOffset;
  DWORD dwRedirectingIDNameSize;
  DWORD dwRedirectingIDNameOffset;
  DWORD dwAppNameSize;
  DWORD dwAppNameOffset;
  DWORD dwDisplayableAddressSize; 
  DWORD dwDisplayableAddressOffset; 
  DWORD dwCalledPartySize;
  DWORD dwCalledPartyOffset;
  DWORD dwCommentSize;
  DWORD dwCommentOffset;
  DWORD dwDisplaySize;
  DWORD dwDisplayOffset;
  DWORD dwUserUserInfoSize;
  DWORD dwUserUserInfoOffset;
  DWORD dwHighLevelCompSize;
  DWORD dwHighLevelCompOffset;
  DWORD dwLowLevelCompSize;
  DWORD dwLowLevelCompOffset;
  DWORD dwChargingInfoSize;
  DWORD dwChargingInfoOffset;
  DWORD dwTerminalModesSize;
  DWORD dwTerminalModesOffset;
  DWORD dwDevSpecificSize;
  DWORD dwDevSpecificOffset;
} LINECALLINFO, FAR* LPLINECALLINFO;

Os membros

dwTotalSize
Tamanho total, em bytes, alocadas para este estrutura de dados.

dwNeededSize
Tamanho, em bytes, para este estrutura de dados necessários para conter todos os dados retornados.

dwUsedSize
Tamanho, em bytes, da parte desta estrutura de dados que contém dados úteis.

hLine
Manipular para o dispositivo de linha com a qual este chamar está associado.

dwLineDeviceID
Identificador de dispositivo do dispositivo de linha com a qual este chamar está associado.

dwAddressID
Identificador de endereço do endereço na linha na qual esta chamar existe.

dwBearerMode
Valor que especifica o atual modo de transmissão do chamar. Ele usa LINEBEARERMODE.

dwRate
Taxa de fluxo de dados de chamar, no bits por segundo (bps).

dwMediaMode
Valor que especifica o modo de mídia do fluxo de dados atualmente na chamar. Este é o modo de mídia determinado pelo proprietário do chamar, que não é necessariamente o mesmo do último LINE_MONITORMEDIA mensagem. Este membro não é diretamente afetado pelas mensagens LINE_MONITORMEDIA. Ele usa LINEMEDIAMODE.

dwAppSpecific
Não interpretada pelo provedor de implementação e serviço API.

dwCallID
Em alguns ambientes telefonia, a alternar ou serviço provedor pode atribuir um identificador exclusivo para cada chamar. Isso permite que a chamar para ser controlados por transferências, encaminhamentos ou outros eventos. O domínio desses chamar identificadores e seu escopo é service_provider-definido. O dwCallID membro torna este identificador exclusivo disponível para os aplicativos.

dwRelatedCallID
Ambientes de telefonia que usam o identificador chamar geralmente podem localizar ele necessárias para relacionar uma chamar para outro. O dwRelatedCallID membro pode ser usado pelo provedor de serviço para essa finalidade.

dwCallParamFlags
Especifica uma coleção de chamar-relacionado parâmetros quando a chamar é de saída. Esses são os mesmos parâmetros chamar especificados na lineMakeCall função. Usa este membro LINECALLPARAMFLAGS.

dwCallStates
Valor que especifica os estados chamar LINECALLSTATE_ tipo para o qual o aplicativo pode ser notificado sobre este chamar. O dwCallStates membro é constante em LINECALLINFO e faz não alteração depending on o estado chamar. Ele usa LINECALLSTATE.

dwMonitorDigitModes
Valor que especifica o vários modos dígito usando LINEDIGITMODE.

dwMonitorMediaModes
Especifica o vários modos de mídia para qual monitoração está usando atualmente habilitado LINEMEDIAMODE.

DialParams
Os parâmetros discagem atualmente aplicado na chamar, do tipo LINEDIALPARAMS. A menos que esses parâmetros são definidos por um lineMakeCall ou o lineSetCallParams função, seus valores são os mesmos que os padrões usados na LINEDEVCAPS estrutura.

dwOrigin
Valor que identifica onde o chamar se originou. Ele usa LINECALLORIGIN.

dwReason
Valor que especifica o motivo por que ocorreu a chamar. Ele usa LINECALLREASON.

dwCompletionID
Valor que especifica o identificador de conclusão para a de entrada chamar se ele for o resultado de uma solicitação de conclusão que termina. Esse identificador é significativo somente se dwReason é LINECALLREASON_CALLCOMPLETION.

dwNumOwners
Número de aplicativo módulos com diferente chamar manipula com privilégio proprietário para o chamar.

dwNumMonitors
Número de aplicativo módulos com diferente chamar manipula com privilégio monitor para o chamar.

dwCountryCode
Codificar Country/Region de parte de destino. Zero se desconhecido.

dwTrunk
Número do tronco através da qual a chamar é roteada. Esse membro é usado para de entrada e de saída chamadas. O dwTrunk membro deve ser definido para 0xFFFFFFFF se ele for desconhecido.

dwCallerIDFlags
Valor que determina a validade e de conteúdo da parte chamador dados identificador. O chamador for o originador do chamar. Ele usa LINECALLPARTYID.

dwCallerIDSize
Tamanho, em bytes, do campo que contém os dados que identifica o chamador.

dwCallerIDOffset
Deslocamento, em bytes, do início deste estrutura de dados.

dwCallerIDNameSize
Tamanho, em bytes, do campo que contém os dados que identifica o nome da parte chamado.

dwCallerIDNameOffset
Deslocamento, em bytes, do início deste estrutura de dados.

dwCalledIDFlags
Valor que determina a validade e de conteúdo do chamado-parte dados identificador. O chamado parte corresponde à parte originalmente endereçada. Ele usa LINECALLPARTYID.

dwCalledIDSize
Tamanho, em bytes, do campo que contém o chamado-parte dados número identificador.

dwCalledIDOffset
Deslocamento, em bytes, do início deste estrutura de dados.

dwCalledIDNameSize
Tamanho, em bytes, do campo que contém o chamado-parte dados nome identificador.

dwCalledIDNameOffset
Deslocamento, em bytes, do início deste estrutura de dados.

dwConnectedIDFlags
Valor que determina a validade e de conteúdo da parte conectada dados identificador. A parte conectada é a parte que realmente foi conectado ao. Isso pode ser diferente a partir de chamado-parte identificador se a chamar foi desviado. Ele usa LINECALLPARTYID.

dwConnectedIDSize
Tamanho, em bytes, o campo que contém a parte conectada de dados número identificador

dwConnectedIDOffset
Deslocamento, em bytes, do início deste estrutura de dados.

dwConnectedIDNameSize
Tamanho, em bytes, do campo que contém a parte conectada dados nome identificador.

dwConnectedIDNameOffset
Deslocamento, em bytes, do início deste estrutura de dados.

dwRedirectionIDFlags
Valor que determina a validade e de conteúdo de parte de redirecionamento dados identificador. A parte de redirecionamento identifica para o usuário chamado de número na direção que diversion foi chamado. Ele usa LINECALLPARTYID.

dwRedirectionIDSize
Tamanho, em bytes, o campo que contém a parte de redirecionamento de dados número identificador.

dwRedirectionIDOffset
Deslocamento, em bytes, do início deste estrutura de dados.

dwRedirectionIDNameSize
Tamanho, em bytes, o campo que contém a parte de redirecionamento de dados nome identificador.

dwRedirectionIDNameOffset
Deslocamento, em bytes, do início deste estrutura de dados.

dwRedirectingIDFlags
Valor que determina a validade e de conteúdo da parte redirecionem dados identificador. A parte que recebeu a chamar identifica o novo número destino ou qualquer dados for detectados para o originador chamar. Ele usa o LINECALLPARTYID. .

dwRedirectingIDSize
Tamanho, em bytes, do campo que contém a parte redirecionem dados número identificador

dwRedirectingIDOffset
Deslocamento, em bytes, do início deste estrutura de dados.

dwRedirectingIDNameSize
Tamanho, em bytes, do campo que contém a parte redirecionem dados nome identificador

dwRedirectingIDNameOffset
Deslocamento, em bytes, do início deste estrutura de dados.

dwAppNameSize
Tamanho, em bytes, do campo que contém a nome do aplicativo do aplicativo que primeiro teve origem, aceita ou respondidas a chamar.

dwAppNameOffset
Deslocamento, em bytes, do início deste estrutura de dados. Este é o nome que um aplicativo pode especificar in a lineInitializeEx função. Se o aplicativo especifica esse nome não, em seguida, módulo arquivo Nome do aplicativo será usado em vez disso.

dwDisplayableAddressSize
Especifique o seqüência de caracteres exibível é usada para fins log. Os dados são obtidos LINECALLPARAMS Para funções que iniciar chamadas. O lineTranslateAddress função retorna apropriado dados sejam colocados nesse membro na dwDisplayableAddressSize membro das LINETRANSLATEOUTPUT estrutura.

dwDisplayableAddressOffset
Especifique o seqüência de caracteres exibível é usada para fins log. Os dados são obtidos LINECALLPARAMS Para funções que iniciar chamadas. O lineTranslateAddress função retorna apropriado dados sejam colocados nesse membro na dwDisplayableAddressSize e dwDisplayableAddressOffset Os membros das LINETRANSLATEOUTPUT estrutura.

dwCalledPartySize
Tamanho, em bytes, do campo que contém um amigável descrição do chamado parte

dwCalledPartyOffset
Deslocamento, em bytes, do início deste estrutura de dados. Este dados podem ser especificados com lineMakeCall e pode ser especificado opcionalmente na lpCallParams parâmetro sempre que um novo chamar é estabelecida. Ele é útil para fins log chamar.

dwCommentSize
Tamanho, em bytes, do campo que contém um comentar sobre o chamar fornecido pelo aplicativo que originou a chamar usando lineMakeCall.

dwCommentOffset
Deslocamento, em bytes, do início deste estrutura de dados. Este dados podem ser especificados opcionalmente na lpCallParams parâmetro sempre que um novo chamar é estabelecida.

dwDisplaySize
Tamanho, em bytes, do campo que armazena processado exibir dados.

dwDisplayOffset
Deslocamento, em bytes, do início deste estrutura de dados. Depending on o ambiente telefonia, um provedor serviço pode extrair dados funcional do par membro para formatação e apresentação mais apropriado para esta configuração telefonia.

dwUserUserInfoSize
Tamanho, em bytes, do campo que contém usuário-usuário dados.

dwUserUserInfoOffset
Deslocamento, em bytes, do início deste estrutura de dados O campo discriminador protocolo para o usuário-usuário dados, se usado, é exibido como o primeiro byte de dados apontados pelo dwUserUserInfoOffsete é contabilizado para em dwUserUserInfoSize.

dwHighLevelCompSize
Tamanho, em bytes, do campo que armazena dados de alto nível compatibilidade.

dwHighLevelCompOffset
Deslocamento, em bytes, do início deste estrutura de dados. O formato deste dados é especificado por outros padrões (Q.931 ISDN).

dwLowLevelCompSize
Tamanho, em bytes, do campo que armazena dados de nível inferior compatibilidade.

dwLowLevelCompOffset
Deslocamento, em bytes, do início deste estrutura de dados. O formato deste dados é especificado por outros padrões (Q.931 ISDN).

dwChargingInfoSize
Tamanho, em bytes, do campo que armazena dados carregando.

dwChargingInfoOffset
Deslocamento, em bytes, do início deste estrutura de dados. O formato deste dados é especificado por outros padrões (Q.931 ISDN).

dwTerminalModesSize
Tamanho, em bytes, do campo de variably tamanho dispositivo que contém uma matriz com DWORD-Tamanho entradas.

dwTerminalModesOffset
Deslocamento, em bytes, do início deste estrutura de dados. O conjunto de LINETERMMODE é indexado pelo terminal identificadores, no intervalo de zero para uma menor dwNumTerminals. Cada entrada na matriz especifica o atual terminal modos para o correspondente terminal definido com o lineSetTerminal função para transmitir de mídia deste chamar. O seguinte valores são predefinidos.

dwDevSpecificSize
Tamanho, em bytes, do campo que armazena dados Device-specific.

dwDevSpecificOffset
Deslocamento, em bytes, do início deste estrutura de dados.

Remarks

Extensões específicas do dispositivo devem usar o DevSpecific (dwDevSpecificSize e dwDevSpecificOffset) dimensionados área deste estrutura de dados variably.

O LINECALLINFO estrutura de dados contém dados relativamente fixos sobre um chamar. Essa estrutura é retornada com lineGetCallInfo. Quando tem alterado dados itens este estrutura de dados, uma mensagem LINE_CALLINFO é enviada para o aplicativo. Um parâmetro para esta mensagem é a item de dados ou campo que alteradas.

Os membros dwCallTreatment Por meio dwReceivingFlowspecOffset Está disponível somente para aplicativos que aberto o dispositivo de linha com uma versão API do 2.0 ou posterior.

Observação

O formato preferido para especificação do conteúdo das dwCallID membro e o outro (cinco membros semelhantesdwCallerIDFlag, dwCallerIDSize, dwCallerIDOffset, dwCallerIDNameSize, e dwCallerIDNameOffset) é o formato canônico número TAPI.De exemplo, um ICLID de 4258828080 recebida da alternar deve ser convertido em " + 1 (425) 8828080" Antes que está sendo colocado na LINECALLINFO estrutura.Esse formato padronizado facilita a pesquisa dos bancos de dados e callback funções implementadas em aplicativos.

Requirements

Header	tapi.h
Windows Embedded CE	Windows CE 1.0 and later
Windows Mobile	Windows Mobile Version 5.0 and later

Compartilhar via

LINECALLINFO

Syntax

Os membros

Remarks

Requirements

See Also

Reference

Recursos adicionais