Estructura LINEDEVSTATUS (tapi.h)

Artículo
08/26/2023

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.