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 |