função TSPI_lineGetCallStatus (tspi.h)
A função TSPI_lineGetCallStatus retorna o status atual da chamada especificada.
Sintaxe
LONG TSPIAPI TSPI_lineGetCallStatus(
HDRVCALL hdCall,
LPLINECALLSTATUS lpCallStatus
);
Parâmetros
hdCall
O identificador do provedor de serviços para a chamada a ser consultada para seu status. O estado de chamada de hdCall pode ser qualquer estado.
lpCallStatus
Um ponteiro para uma estrutura de dados de tamanho variável do tipo LINECALLSTATUS. Essa estrutura é preenchida com informações de status de chamada.
Valor retornado
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 LINECALLSTATUS são preenchidos pelo provedor de serviços e quais membros são preenchidos pelo TAPI. 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 | |
| dwCallState; | X | |
| dwCallStateMode; | X | |
| dwCallPrivilege; | X | |
| dwCallFeatures; | X | |
| dwDevSpecificSize; | X | |
| dwDevSpecificOffset; | X |
TSPI_lineGetCallStatus retorna a status dinâmica de uma chamada, enquanto TSPI_lineGetCallInfo retorna principalmente informações estáticas sobre uma chamada. As informações de chamada status incluem o estado de chamada atual, informações detalhadas de modo relacionadas à chamada enquanto estiver nesse estado (se houver), bem como uma lista das funções TSPI disponíveis que TAPI pode invocar na chamada enquanto a chamada estiver nesse estado.
Requisitos
| Plataforma de Destino | Windows |
| Cabeçalho | tspi.h |