Compartilhar via


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

Confira também

Completion_Proc

TSPI_lineOpen