Função de retorno de chamada LINEEVENT (tspi.h)
Line_Event é uma função de retorno de chamada implementada pelo TAPI e fornecida ao provedor de serviços como um parâmetro para TSPI_lineOpen. O provedor de serviços chama essa função para relatar eventos que ocorrem na linha ou em chamadas na linha.
O tipo LINEEVENT define um ponteiro para essa função de retorno de chamada. Line_Event é um espaço reservado para o nome da função definida pelo aplicativo.
Sintaxe
LINEEVENT Lineevent;
void Lineevent(
HTAPILINE htLine,
HTAPICALL htCall,
DWORD dwMsg,
DWORD_PTR dwParam1,
DWORD_PTR dwParam2,
DWORD_PTR dwParam3
)
{...}
Parâmetros
htLine
O identificador TAPI para a linha na qual o evento ocorreu.
htCall
O identificador TAPI para a chamada na qual o evento ocorreu se esse for um evento relacionado à chamada. Para eventos relacionados a linhas em que não há nenhuma chamada, esse parâmetro é definido como NULL.
dwMsg
Especifica o tipo de evento que está sendo relatado. A interpretação dos outros parâmetros é executada de maneiras diferentes de acordo com o contexto indicado por dwMsg.
dwParam1
Um parâmetro para a mensagem.
dwParam2
Um parâmetro para a mensagem.
dwParam3
Um parâmetro para a mensagem.
Retornar valor
Nenhum
Comentários
O estado de chamada ao chamar essa função pode ser qualquer estado.
O provedor de serviços passa o valor HTAPILINE fornecido para TSPI_lineOpen como o parâmetro htLine . Ele inclui o identificador de mensagem e os parâmetros específicos para o evento.
Essa função difere da função de retorno de chamada definida no nível TAPI, pois separa os parâmetros de linha e chamada. Ambos os parâmetros são usados para algumas mensagens. Os conjuntos de mensagens que podem ser passadas para esse procedimento diferem ligeiramente do nível TAPI. Em particular, a conclusão de solicitações de execução assíncrona é relatada por meio do retorno de chamada Completion_Proc em vez desta.
Requisitos
| Requisito | Valor |
|---|---|
| Plataforma de Destino | Windows |
| Cabeçalho | tspi.h |