Função TSPI_lineGetCallInfo (tspi.h)
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 |