Estructura LINEDEVSTATUS (tapi.h)
La estructura LINEDEVSTATUS describe el estado actual de un dispositivo de línea. La función lineGetLineDevStatus y la función TSPI_lineGetLineDevStatus devuelven la estructura LINEDEVSTATUS .
Sintaxis
typedef struct linedevstatus_tag {
DWORD dwTotalSize;
DWORD dwNeededSize;
DWORD dwUsedSize;
DWORD dwNumOpens;
DWORD dwOpenMediaModes;
DWORD dwNumActiveCalls;
DWORD dwNumOnHoldCalls;
DWORD dwNumOnHoldPendCalls;
DWORD dwLineFeatures;
DWORD dwNumCallCompletions;
DWORD dwRingMode;
DWORD dwSignalLevel;
DWORD dwBatteryLevel;
DWORD dwRoamMode;
DWORD dwDevStatusFlags;
DWORD dwTerminalModesSize;
DWORD dwTerminalModesOffset;
DWORD dwDevSpecificSize;
DWORD dwDevSpecificOffset;
DWORD dwAvailableMediaModes;
DWORD dwAppInfoSize;
DWORD dwAppInfoOffset;
} LINEDEVSTATUS, *LPLINEDEVSTATUS;
Miembros
dwTotalSize
Tamaño total asignado a esta estructura de datos, en bytes.
dwNeededSize
Tamaño de esta estructura de datos necesaria para contener toda la información devuelta, en bytes.
dwUsedSize
Tamaño de la parte de esta estructura de datos que contiene información útil, en bytes.
dwNumOpens
Número de aperturas activas en el dispositivo de línea.
dwOpenMediaModes
Matriz de bits que indica para qué tipos de medios está abierto actualmente el dispositivo de línea.
dwNumActiveCalls
Número de llamadas en la línea en estados de llamada distintos de inactivos, de retención, onholdpendingtransfer y de retenciónconferencia.
dwNumOnHoldCalls
Número de llamadas en la línea en estado de retención .
dwNumOnHoldPendCalls
Número de llamadas en la línea en el estado onholdpendingtransfer o onholdpendingconference .
dwLineFeatures
Funciones relacionadas con líneas que están disponibles actualmente en esta línea. Este miembro usa una o varias de las constantes de LINEFEATURE_.
dwNumCallCompletions
Número de solicitudes pendientes de finalización de llamadas en la línea.
dwRingMode
Modo de anillo actual en el dispositivo de línea.
dwSignalLevel
Nivel de señal actual de la conexión en la línea. Se trata de un valor del intervalo 0x00000000 (señal más débil) a 0x0000FFFF (señal más fuerte).
dwBatteryLevel
Nivel de batería actual del hardware del dispositivo de línea. Se trata de un valor del intervalo 0x00000000 (batería vacía) para 0x0000FFFF (batería llena).
dwRoamMode
Modo de itinerancia actual del dispositivo de línea. Este miembro usa una de las constantes de LINEROAMMODE_.
dwDevStatusFlags
Marcas que indican información de estado, como si el dispositivo está bloqueado. Consta de uno o varios miembros de LINEDEVSTATUSFLAGS_ Constantes.
dwTerminalModesSize
Tamaño del campo de dispositivo de tamaño variable que contiene una matriz de modos de terminal actuales, en bytes.
dwTerminalModesOffset
Desfase desde el principio de la estructura a una matriz de modos de terminal actuales, en bytes. Esta matriz se indexa mediante identificadores de terminal, en el intervalo de cero a dwNumTerminals menos uno. Cada entrada de la matriz especifica los modos de terminal actuales para el conjunto de terminales correspondiente mediante la función lineSetTerminal para esta línea. Cada entrada es un DWORD que especifica una o varias de las constantes de LINETERMMODE_. El tamaño de la matriz se especifica mediante dwTerminalModesSize.
dwDevSpecificSize
Tamaño del campo específico del dispositivo de tamaño variable, en bytes. Si la información específica del dispositivo es un puntero a una cadena, el tamaño debe incluir el terminador nulo .
dwDevSpecificOffset
Desfase desde el principio de la estructura hasta el campo específico del dispositivo, en bytes. El tamaño del campo se especifica mediante dwDevSpecificSize.
dwAvailableMediaModes
Indica los tipos de medios que se pueden invocar en nuevas llamadas creadas en este dispositivo de línea, cuando el miembro dwLineFeatures indica que se pueden realizar nuevas llamadas. Si este miembro es cero, indica que el proveedor de servicios no sabe o no puede indicar qué tipos de medios están disponibles, en cuyo caso cualquiera o todos los tipos de medios indicados en el miembro dwMediaModes de LINEDEVCAPS pueden estar disponibles.
dwAppInfoSize
Tamaño de la matriz que identifica las aplicaciones que tienen la línea abierta, en bytes.
dwAppInfoOffset
Desfase desde el principio de la estructura hasta una matriz de estructuras LINEAPPINFO . El miembro dwNumOpens indica el número de elementos de la matriz. Cada elemento de la matriz identifica una aplicación que tiene abierta la línea. DwAppInfoSize especifica el tamaño de la matriz.
Comentarios
Las extensiones específicas del dispositivo deben usar el área de tamaño variable DevSpecific (dwDevSpecificSize y dwDevSpecificOffset) de esta estructura de datos.
Los miembros dwAvailableMediaModes a través de dwAppInfoOffset solo están disponibles para las aplicaciones que abren el dispositivo de línea con una versión de API de 2.0 o posterior.
Requisitos
| Encabezado | tapi.h |