Compartilhar via

Função TSPI_lineGetCallInfo (tspi.h)

  • Artigo

A função TSPI_lineGetCallInfo retorna informações detalhadas sobre a chamada especificada.

Sintaxe

LONG TSPIAPI TSPI_lineGetCallInfo(
  HDRVCALL       hdCall,
  LPLINECALLINFO lpCallInfo
);

Parâmetros

hdCall

O identificador do provedor de serviços para a chamada cujas informações de chamada devem ser recuperadas. O estado de chamada de hdCall pode ser qualquer estado.

lpCallInfo

Um ponteiro para uma estrutura de dados de tamanho variável do tipo LINECALLINFO. Após a conclusão bem-sucedida da solicitação, essa estrutura é preenchida com informações relacionadas à chamada.

Retornar valor

Retornará zero se a função for bem-sucedida ou um número de erro se ocorrer um erro. Os possíveis valores retornados são os seguintes:

LINEERR_INVALCALLHANDLE, LINEERR_OPERATIONFAILED, LINEERR_NOMEM, LINEERR_RESOURCEUNAVAIL, LINEERR_OPERATIONUNAVAIL.

Comentários

A tabela a seguir indica quais membros da estrutura de dados LINECALLINFO são preenchidos pelo TAPI e quais membros são preenchidos pelo provedor de serviços. O provedor de serviços deve preservar (não deve substituir) os valores preenchidos pelo TAPI.

Nome do membro TAPI Provedor de serviços
Dwtotalsize; X
Dwneededsize; X
dwUsedSize; X
Hline; X
dwLineDeviceID; X
Dwaddressid; X
dwBearerMode; X
Dwrate; X
Dwmediamode; X
dwAppSpecific; X
dwCallID; X
dwRelatedCallID; X
dwCallParamFlags; X
dwCallStates; X X
dwMonitorDigitModes; X
dwMonitorMediaModes; X
DialParams; X
Dworigin; X
Dwreason; X
dwCompletionID; X
dwNumOwners; X
dwNumMonitors; X
Dwcountrycode; X
dwTrunk; X
dwCallerIDFlags; X
dwCallerIDSize; X
dwCallerIDOffset; X
dwCallerIDNameSize; X
dwCallerIDNameOffset; X
dwCalledIDFlags; X
dwCalledIDSize; X
dwCalledIDOffset; X
dwCalledIDNameSize; X
dwCalledIDNameOffset; X
dwConnectedIDFlags; X
dwConnectedIDSize; X
dwConnectedIDOffset; X
dwConnectedIDNameSize; X
dwConnectedIDNameOffset; X
dwRedirectionIDFlags; X
dwRedirectionIDSize; X
dwRedirectionIDOffset; X
dwRedirectionIDNameSize; X
dwRedirectionIDNameOffset; X
dwRedirectingIDFlags; X
dwRedirectingIDSize; X
dwRedirectingIDOffset; X
dwRedirectingIDNameSize; X
dwRedirectingIDNameOffset; X
dwAppNameSize; X
dwAppNameOffset; X
dwDisplayableAddressSize; X
dwDisplayableAddressOffset; X
dwCalledPartySize; X
dwCalledPartyOffset; X
dwCommentSize; X
dwCommentOffset; X
dwDisplaySize; X
dwDisplayOffset; X
dwUserUserInfoSize; X
dwUserUserInfoOffset; X
dwHighLevelCompSize; X
dwHighLevelCompOffset; X
dwLowLevelCompSize; X
dwLowLevelCompOffset; X
dwChargingInfoSize; X
dwChargingInfoOffset; X
dwTerminalModesSize; X
dwTerminalModesOffset; X
dwDevSpecificSize; X
dwDevSpecificOffset; X
 

O TAPI preenche os campos de tamanho e deslocamento para os membros dwAppNameSize/Offset, dwCalledPartySize/Offset e dwCommentSize/Offset e atualiza o valor em dwUsedSize para refleti-los depois de chamar o provedor de serviços.

Depois que o provedor de serviços retorna da função TSPI_lineGetCallInfo , o TAPI define o membro dwCallStates da estrutura LINECALLINFO da seguinte maneira:

LINECALLINFO.dwCallStates |= LINECALLSTATE_UNKNOWN;

Se o provedor de serviços modelar linhas como "pools" de recursos de canal e fizer multiplexação inversa de uma chamada em vários identificadores de endereço, ele deverá escolher consistentemente um desses identificadores de endereço como o identificador primário relatado por essa função na estrutura de dados LINECALLINFO .

Requisitos

Requisito Valor
Plataforma de Destino Windows
Cabeçalho tspi.h