TSPI_lineGetLineDevStatus función (tspi.h)
La función TSPI_lineGetLineDevStatus consulta el dispositivo de línea abierta especificado para su estado actual. La información devuelta es global para todas las direcciones de la línea.
Sintaxis
LONG TSPIAPI TSPI_lineGetLineDevStatus(
HDRVLINE hdLine,
LPLINEDEVSTATUS lpLineDevStatus
);
Parámetros
hdLine
Identificador del proveedor de servicios de la línea que se va a consultar.
lpLineDevStatus
Puntero a una estructura de datos de tamaño variable de tipo LINEDEVSTATUS. Esta estructura se rellena con el estado del dispositivo de la línea.
Valor devuelto
Devuelve cero si la función se realiza correctamente o un número de error si se produce un error. Los valores devueltos posibles son los siguientes:
LINEERR_INVALLINEHANDLE, LINEERR_OPERATIONFAILED, LINEERR_NOMEM, LINEERR_RESOURCEUNAVAIL, LINEERR_OPERATIONUNAVAIL.
Comentarios
En la tabla siguiente se indican los miembros de la estructura de datos LINEDEVSTATUS rellenados por TAPI y que el proveedor de servicios rellena. El proveedor de servicios debe conservar (no debe sobrescribir) los valores rellenados por TAPI.
| Nombre del miembro | TAPI | Proveedor de servicios |
|---|---|---|
| dwTotalSize; | X | |
| dwNeededSize; | X | |
| dwUsedSize; | X | |
| dwNumOpens; | X | |
| dwOpenMediaModes; | X | |
| dwNumActiveCalls; | X | |
| dwNumOnHoldCalls; | X | |
| dwNumOnHoldPendCalls; | X | |
| dwLineFeatures; | X | |
| dwNumCallCompletions; | X | |
| dwRingMode; | X | |
| dwSignalLevel; | X | |
| dwBatteryLevel; | X | |
| dwRoamMode; | X | |
| dwDevStatusFlags; | X | |
| dwTerminalModesSize; | X | |
| dwTerminalModesOffset; | X | |
| dwDevSpecificSize; | X | |
| dwDevSpecificOffset; | X |
Requisitos
| Requisito | Value |
|---|---|
| Plataforma de destino | Windows |
| Encabezado | tspi.h |