ASYNC_COMPLETION función de devolución de llamada (tspi.h)

Artículo
03/08/2023

Completion_Proc es una función de devolución de llamada implementada por TAPI y proporcionada al proveedor de servicios como parámetro para TSPI_providerInit. El proveedor de servicios llama a esta función para informar de la finalización de una línea o procedimiento telefónico que se ejecuta de forma asincrónica.

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

Sintaxis

ASYNC_COMPLETION AsyncCompletion;

void AsyncCompletion(
  DRV_REQUESTID dwRequestID,
  LONG lResult
)
{...}

Parámetros

dwRequestID

Identificador pasado en la solicitud original que el proveedor de servicios ejecutó de forma asincrónica.

lResult

Resultado de la operación. Puede ser cero para indicar que se ha realizado correctamente o un número negativo para indicar un error. Los posibles valores de error específicos que pueden resultar de una función son los mismos para la ejecución asincrónica o sincrónica.

Valor devuelto

None

Observaciones

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

TAPI proporciona este procedimiento en el momento en que se inicializa un proveedor de servicios con la función TSPI_providerInit . Algunos de los procedimientos de TSPI que operan en dispositivos de línea, llamada y teléfono especifican una operación asincrónica. Estos procedimientos incluyen un parámetro dwRequestID para identificar la solicitud. Cuando se llama a este procedimiento, el proveedor de servicios puede devolver un número negativo para un error si se detecta uno inmediatamente o el dwRequestID positivo si la operación continúa asincrónicamente. El proveedor de servicios debe notificar la finalización exactamente una vez para cada solicitud que se ejecuta de forma asincrónica. Para ello, llama a este procedimiento. El proveedor de servicios no puede llamar a este procedimiento o al procedimiento Line_Event o Phone_Event de nuevo hasta que este procedimiento vuelva.

El proveedor de servicios puede llamar a la función Completion_Proc antes de que vuelva de la primera solicitud. TAPI garantiza no llamar al proveedor de servicios desde dentro del contexto de Completion_Proc excepto cuando se indique.

Esto no tiene ninguna correspondencia directa en el nivel TAPI porque en ese nivel las finalizaciones asincrónicas de función se notifican como un mensaje pasado a través de la misma interfaz de devolución de llamada que se usa para mensajes de eventos espontáneas. En el nivel de TSPI, los eventos espontáneas se notifican a través del Line_Event y Phone_Event procedimientos de devolución de llamada.