Función de devolución de llamada LINEEVENT (tspi.h)

Line_Event es una función de devolución de llamada implementada por TAPI y proporcionada al proveedor de servicios como parámetro para TSPI_lineOpen. El proveedor de servicios llama a esta función para notificar eventos que se producen en la línea o en las llamadas en la línea.

El tipo LINEEVENT define un puntero a esta función de devolución de llamada. Line_Event es un marcador de posición para el nombre de función definido por la aplicación.

Sintaxis

LINEEVENT Lineevent;

void Lineevent(
  HTAPILINE htLine,
  HTAPICALL htCall,
  DWORD dwMsg,
  DWORD_PTR dwParam1,
  DWORD_PTR dwParam2,
  DWORD_PTR dwParam3
)
{...}

Parámetros

htLine

Identificador TAPI para la línea en la que se produjo el evento.

htCall

Identificador TAPI de la llamada en la que se produjo el evento si se trata de un evento relacionado con la llamada. En el caso de los eventos relacionados con la línea en los que no hay ninguna llamada, este parámetro se establece en NULL.

dwMsg

Especifica el tipo de evento que se está notificando. La interpretación de los demás parámetros se realiza de diferentes maneras según el contexto indicado por dwMsg.

dwParam1

Parámetro para el mensaje.

dwParam2

Parámetro para el mensaje.

dwParam3

Parámetro para el mensaje.

Valor devuelto

None

Observaciones

El estado de llamada al llamar a esta función puede ser cualquier estado.

El proveedor de servicios pasa el valor HTAPILINE proporcionado a TSPI_lineOpen como parámetro htLine . Incluye el identificador de mensaje y los parámetros específicos del evento.

Esta función difiere de la función de devolución de llamada definida en el nivel TAPI en que separa los parámetros de línea y llamada. Ambos parámetros se usan para algunos mensajes. Los conjuntos de mensajes que se pueden pasar a este procedimiento difieren ligeramente del nivel TAPI. En concreto, la finalización de solicitudes que se ejecutan de forma asincrónica se notifica a través de la devolución de llamada Completion_Proc en lugar de esta.

Requisitos

Requisito	Value
Plataforma de destino	Windows
Encabezado	tspi.h

Consulte también

Completion_Proc

TSPI_lineOpen