TSPI_lineReleaseUserUserInfo función (tspi.h)
La función TSPI_lineReleaseUserUserInfo informa al proveedor de servicios de que se ha procesado la información del usuario-usuario contenida en la estructura LINECALLINFO y que posteriormente se puede escribir la información del usuario-usuario en esa estructura. El proveedor de servicios envía un mensaje de LINE_CALLINFO que indica LINECALLINFOSTATE_USERUSERINFO cuando hay nueva información disponible.
Sintaxis
LONG TSPIAPI TSPI_lineReleaseUserUserInfo(
DRV_REQUESTID dwRequestID,
HDRVCALL hdCall
);
Parámetros
dwRequestID
Identificador de la solicitud asincrónica.
hdCall
Identificador del proveedor de servicios para la llamada para la que se va a liberar información del usuario-usuario. El estado de llamada de hdCall puede ser cualquiera.
Valor devuelto
Devuelve dwRequestID o un número de error si se produce un error. El parámetro real lResult del ASYNC_COMPLETION correspondiente es cero si la función se ejecuta correctamente o un número de error si se produce un error. Los valores devueltos posibles son los siguientes:
LINEERR_INVALCALLHANDLE, LINEERR_OPERATIONFAILED, LINEERR_NOMEM, LINEERR_RESOURCEUNAVAIL.
Comentarios
La función TSPI_lineReleaseUserUserInfo permite controlar el flujo de información entrante del usuario-usuario en una conexión ISDN. Cuando se recibe un mensaje de información de usuario completo, el proveedor de servicios informa a TAPI mediante un mensaje de LINE_CALLINFO (especificando LINECALLINFOSTATE_USERUSERINFO). La información del usuario y otros campos de LINECALLINFO se pueden examinar mediante varias llamadas a TSPI_lineGetCallInfo. El proveedor de servicios no debe sobrescribir la información anterior del usuario-usuario en LINECALLINFO con información más reciente hasta que se haya llamado a TSPI_lineReleaseUserUserInfo . El proveedor de servicios debe almacenar en búfer la información de usuario recibida posteriormente hasta que se libere la información anterior. Se puede descartar cualquier información almacenada en búfer restante cuando se invoca TSPI_lineCloseCall .
Si se invoca esta función mientras no hay información de usuario en LINECALLINFO, el proveedor de servicios debe devolver, sin embargo, una indicación de éxito.
Por compatibilidad con versiones anteriores, TAPI devuelve automáticamente LINEERR_OPERATIONUNAVAIL si se invoca esta función para una llamada en una línea bajo el control de un proveedor de servicios que no exporta la función.
Requisitos
| Requisito | Value |
|---|---|
| Plataforma de destino | Windows |
| Encabezado | tspi.h |