Estructura LINEDEVCAPS (tapi.h)

Artículo
03/08/2023

La estructura LINEDEVCAPS describe las funcionalidades de un dispositivo de línea. La función lineGetDevCaps y la función TSPI_lineGetDevCaps devuelven la estructura LINEDEVCAPS .

Sintaxis

typedef struct linedevcaps_tag {
  DWORD          dwTotalSize;
  DWORD          dwNeededSize;
  DWORD          dwUsedSize;
  DWORD          dwProviderInfoSize;
  DWORD          dwProviderInfoOffset;
  DWORD          dwSwitchInfoSize;
  DWORD          dwSwitchInfoOffset;
  DWORD          dwPermanentLineID;
  DWORD          dwLineNameSize;
  DWORD          dwLineNameOffset;
  DWORD          dwStringFormat;
  DWORD          dwAddressModes;
  DWORD          dwNumAddresses;
  DWORD          dwBearerModes;
  DWORD          dwMaxRate;
  DWORD          dwMediaModes;
  DWORD          dwGenerateToneModes;
  DWORD          dwGenerateToneMaxNumFreq;
  DWORD          dwGenerateDigitModes;
  DWORD          dwMonitorToneMaxNumFreq;
  DWORD          dwMonitorToneMaxNumEntries;
  DWORD          dwMonitorDigitModes;
  DWORD          dwGatherDigitsMinTimeout;
  DWORD          dwGatherDigitsMaxTimeout;
  DWORD          dwMedCtlDigitMaxListSize;
  DWORD          dwMedCtlMediaMaxListSize;
  DWORD          dwMedCtlToneMaxListSize;
  DWORD          dwMedCtlCallStateMaxListSize;
  DWORD          dwDevCapFlags;
  DWORD          dwMaxNumActiveCalls;
  DWORD          dwAnswerMode;
  DWORD          dwRingModes;
  DWORD          dwLineStates;
  DWORD          dwUUIAcceptSize;
  DWORD          dwUUIAnswerSize;
  DWORD          dwUUIMakeCallSize;
  DWORD          dwUUIDropSize;
  DWORD          dwUUISendUserUserInfoSize;
  DWORD          dwUUICallInfoSize;
  LINEDIALPARAMS MinDialParams;
  LINEDIALPARAMS MaxDialParams;
  LINEDIALPARAMS DefaultDialParams;
  DWORD          dwNumTerminals;
  DWORD          dwTerminalCapsSize;
  DWORD          dwTerminalCapsOffset;
  DWORD          dwTerminalTextEntrySize;
  DWORD          dwTerminalTextSize;
  DWORD          dwTerminalTextOffset;
  DWORD          dwDevSpecificSize;
  DWORD          dwDevSpecificOffset;
  DWORD          dwLineFeatures;
  DWORD          dwSettableDevStatus;
  DWORD          dwDeviceClassesSize;
  DWORD          dwDeviceClassesOffset;
  GUID           PermanentLineGuid;
  DWORD          dwAddressTypes;
  GUID           ProtocolGuid;
  DWORD          dwAvailableTracking;
} LINEDEVCAPS, *LPLINEDEVCAPS;

Miembros

dwTotalSize

Tamaño total asignado a esta estructura de datos, en bytes.

dwNeededSize

Tamaño necesario para que esta estructura de datos contenga 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.

dwProviderInfoSize

Tamaño del campo de tamaño variable que contiene información del proveedor de servicios, en bytes.

dwProviderInfoOffset

Desplazamiento desde el principio de la estructura hasta la información del proveedor de servicios, en bytes.

Los miembros dwProviderInfoSize y dwProviderInfoOffset están diseñados para proporcionar información sobre el hardware o el software del proveedor, como el nombre del proveedor y los números de versión de hardware y software. Esta información puede ser útil cuando un usuario necesita llamar al servicio de atención al cliente con problemas relacionados con el proveedor.

dwSwitchInfoSize

Tamaño del campo de dispositivo de tamaño variable que contiene información del conmutador, en bytes.

dwSwitchInfoOffset

Desplazamiento desde el principio de la estructura hasta la información del modificador, en bytes.

Los miembros dwSwitchInfoSize y dwSwitchInfoOffset están diseñados para proporcionar información sobre el conmutador al que está conectado el dispositivo de línea, como el fabricante del conmutador, el nombre del modelo, la versión de software, etc. Esta información puede ser útil cuando un usuario necesita llamar al servicio de atención al cliente con problemas relacionados con el cambio.

dwPermanentLineID

Identificador permanente por el que se conoce el dispositivo de línea en la configuración del sistema. Es un nombre permanente para el dispositivo de línea. Este nombre permanente (en lugar de dwDeviceID) no cambia a medida que se agregan o quitan líneas del sistema y se conservan a través de las actualizaciones del sistema operativo. Por lo tanto, se puede usar para vincular información específica de línea en .ini archivos (u otros archivos) de una manera que no se vea afectada agregando o quitando otras líneas o cambiando el sistema operativo.

dwLineNameSize

Tamaño del campo de dispositivo de tamaño variable que contiene un nombre configurable por el usuario para este dispositivo de línea, en bytes.

dwLineNameOffset

Desplazamiento desde el principio de esta estructura de datos hasta el nombre de este dispositivo de línea. El usuario puede configurar este nombre al configurar el proveedor de servicios del dispositivo de línea y se proporciona para la comodidad del usuario. DwLineNameSize especifica el tamaño del campo.

dwStringFormat

Formato de cadena usado con este dispositivo de línea. Este miembro usa una de las STRINGFORMAT_ constantes.

dwAddressModes

Modo por el que se especifica la dirección de origen. Este miembro usa las constantes LINEADDRESSMODE_.

dwNumAddresses

Número de direcciones asociadas a este dispositivo de línea. Los identificadores de dirección hacen referencia a direcciones individuales. Los identificadores de dirección van de cero a uno menor que el valor indicado por dwNumAddresses.

dwBearerModes

Matriz de marcas que indica los diferentes modos de portador que la dirección puede admitir. Este miembro usa una o varias de las constantes de LINEBEARERMODE_.

dwMaxRate

Velocidad máxima de datos para el intercambio de información a través de la llamada, en bits por segundo.

dwMediaModes

Matriz de marcas que indica los distintos tipos de medios que la dirección puede admitir. Este miembro usa una o varias de las constantes de LINEMEDIAMODE_.

dwGenerateToneModes

Tonos que se pueden generar en esta línea. Este miembro usa una o varias de las constantes de LINETONEMODE_.

dwGenerateToneMaxNumFreq

Número máximo de frecuencias que se pueden especificar para describir un tono general mediante la estructura de datos LINEGENERATETONE al generar un tono mediante lineGenerateTone. Un valor de 0 indica que la generación de tonos no está disponible.

dwGenerateDigitModes

Modos de dígito que se pueden generar en esta línea. Este miembro usa una o varias de las constantes de LINEDIGITMODE_.

dwMonitorToneMaxNumFreq

Número máximo de frecuencias que se pueden especificar en la descripción de un tono general mediante la estructura de datos LINEMONITORTONE al supervisar un tono general mediante lineMonitorTones. Un valor de 0 indica que el monitor de tono no está disponible.

dwMonitorToneMaxNumEntries

Número máximo de entradas que se pueden especificar en una lista de tonos para lineMonitorTones.

dwMonitorDigitModes

Modos de dígito que se pueden detectar en esta línea. Este miembro usa una o varias de las constantes de LINEDIGITMODE_.

dwGatherDigitsMinTimeout

Valor mínimo que se puede especificar para los valores de tiempo de espera de primer dígito y entre dígitos usados por lineGatherDigits, en milisegundos. Si dwGatherDigitsMinTimeout y dwGatherDigitsMaxTimeout son cero, no se admiten tiempos de espera.

dwGatherDigitsMaxTimeout

Valor máximo que se puede especificar para los valores de tiempo de espera de primer dígito y entre dígitos usados por lineGatherDigits, en milisegundos. Si dwGatherDigitsMinTimeout y dwGatherDigitsMaxTimeout son cero, no se admiten tiempos de espera.

dwMedCtlDigitMaxListSize

Número máximo de entradas que se pueden especificar en el parámetro de lista de dígitos de lineSetMediaControl.

dwMedCtlMediaMaxListSize

Número máximo de entradas que se pueden especificar en el parámetro de lista de medios de lineSetMediaControl.

dwMedCtlToneMaxListSize

Número máximo de entradas que se pueden especificar en el parámetro de lista de tonos de lineSetMediaControl.

dwMedCtlCallStateMaxListSize

Número máximo de entradas que se pueden especificar en el parámetro de lista de estado de llamada de lineSetMediaControl.

dwDevCapFlags

Funcionalidades de dispositivo booleanas. Este miembro usa una o varias de las constantes de LINEDEVCAPFLAGS_.

dwMaxNumActiveCalls

Número máximo de llamadas (ancho de banda mínimo) que pueden estar activas (conectadas) en la línea en cualquier momento. El número real de llamadas activas puede ser menor si se han establecido llamadas de ancho de banda más altas en la línea.

dwAnswerMode

Efecto en la llamada activa al responder a otra llamada de oferta en un dispositivo de línea. Este miembro usa una de las constantes LINEANSWERMODE_.

dwRingModes

Número de modos de anillo diferentes que se pueden notificar en el mensaje de LINE_LINEDEVSTATE con la indicación de timbre . Los diferentes modos de anillo van de uno a dwRingModes. Cero indica que no hay ningún anillo.

dwLineStates

Diferentes componentes de estado de línea para los que se puede notificar a la aplicación en un mensaje de LINE_LINEDEVSTATE en esta línea. Este miembro usa una o varias de las constantes de LINEDEVSTATE_.

dwUUIAcceptSize

Tamaño máximo de la información de usuario-usuario, incluido el terminador NULL , que se puede enviar durante una aceptación de llamada.

dwUUIAnswerSize

Tamaño máximo de la información de usuario-usuario, incluido el terminador NULL , que se puede enviar durante una respuesta de llamada.

dwUUIMakeCallSize

Tamaño máximo de la información de usuario-usuario, incluido el terminador NULL , que se puede enviar durante una llamada make.

dwUUIDropSize

Tamaño máximo de la información de usuario-usuario, incluido el terminador NULL , que se puede enviar durante una eliminación de llamadas.

dwUUISendUserUserInfoSize

Tamaño máximo de la información de usuario-usuario, incluido el terminador NULL , que se puede enviar por separado en cualquier momento durante una llamada con lineSendUserUserInfo.

dwUUICallInfoSize

Tamaño máximo de información de usuario-usuario, incluido el terminador NULL , que se puede recibir en la estructura LINECALLINFO .

MinDialParams

Valor mínimo para los parámetros de marcado que se pueden establecer para las llamadas en esta línea, en milisegundos. Los parámetros de marcado se pueden establecer en valores del intervalo MinDialParams en MaxDialParams. La granularidad de la configuración real es específica del proveedor de servicios.

MaxDialParams

Valor máximo para los parámetros de marcado que se pueden establecer para las llamadas en esta línea, en milisegundos. Los parámetros de marcado se pueden establecer en valores del intervalo MinDialParams en MaxDialParams. La granularidad de la configuración real es específica del proveedor de servicios.

DefaultDialParams

Parámetros de marcado predeterminados usados para las llamadas en esta línea. Estos valores de parámetro se pueden invalidar por llamada.

dwNumTerminals

Número de terminales que se pueden establecer para este dispositivo de línea, sus direcciones o sus llamadas. Los identificadores de terminal hacen referencia a los terminales individuales y van de cero a uno menor que el valor indicado por dwNumTerminals.

dwTerminalCapsSize

Tamaño del campo de dispositivo de tamaño variable que contiene una matriz con entradas de tipo LINETERMCAPS, en bytes.

dwTerminalCapsOffset

Desplazamiento desde el principio de esta estructura hasta el campo de dispositivo de tamaño variable que contiene una matriz con entradas de tipo LINETERMCAPS. Esta matriz se indexa mediante identificadores de terminal, en el intervalo de cero a dwNumTerminals menos uno. Cada entrada de la matriz especifica las funcionalidades del dispositivo terminal del terminal correspondiente. DwTerminalCapsSize especifica el tamaño del campo.

dwTerminalTextEntrySize

Tamaño de cada una de las descripciones de texto de terminal, incluido el terminador null , al que apunta dwTerminalTextSize y dwTerminalTextOffset, en bytes.

dwTerminalTextSize

Tamaño del campo de tamaño variably que contiene texto descriptivo sobre cada uno de los terminales disponibles de la línea, incluido el terminador NULL , en bytes

dwTerminalTextOffset

Desplazamiento desde el principio de esta estructura al texto descriptivo sobre cada uno de los terminales disponibles de la línea, en bytes. Cada mensaje es dwTerminalTextEntrySize bytes long. El formato de cadena de estas descripciones textuales se indica mediante dwStringFormat en las funcionalidades del dispositivo de la línea. DwTerminalTextSize especifica el tamaño del campo.

dwDevSpecificSize

Tamaño del campo específico del dispositivo de tamaño variably, en bytes. Si la información específica del dispositivo es un puntero a una cadena, el tamaño debe incluir el terminador null .

dwDevSpecificOffset

Desplazamiento desde el principio de esta estructura hasta el campo específico del dispositivo, en bytes. El tamaño del campo se especifica mediante dwDevSpecificSize.

dwLineFeatures

Características disponibles para esta línea mediante las constantes LINEFEATURE_. Invocar una característica compatible requiere que la línea esté en el estado adecuado y que el dispositivo de línea subyacente se abra en un modo compatible. Un cero en una posición de bits indica que la característica correspondiente nunca está disponible. Una indica que la característica correspondiente puede estar disponible si la línea está en el estado adecuado para que la operación sea significativa. Este miembro permite a una aplicación detectar qué características de línea pueden ser (y que nunca pueden ser) compatibles con el dispositivo.

dwSettableDevStatus

Valores LINEDEVSTATUSFLAGS que se pueden modificar mediante lineSetLineDevStatus.

dwDeviceClassesSize

Tamaño de una cadena que contiene los identificadores de clase de dispositivo admitidos en una o varias direcciones de esta línea, incluido el terminador NULL , en bytes.

dwDeviceClassesOffset

Desfase desde el principio de esta estructura a una cadena que contiene los identificadores de clase de dispositivo admitidos en una o varias direcciones de esta línea, en bytes. Estas cadenas se usan con lineGetID; están separados por NULLs y el último identificador de la lista va seguido de dos VALORES NULL. El tamaño del campo se especifica mediante dwDeviceClassesSize.

PermanentLineGuid

GUID asociado permanentemente al dispositivo de línea.

dwAddressTypes

Tipo de dirección usado para la llamada. Este miembro de la estructura solo está disponible si la versión de TAPI negociada es 3.0 o posterior.

ProtocolGuid

Protocolo TAPI actual. Este miembro de la estructura solo está disponible si la versión de TAPI negociada es 3.0 o posterior. Los protocolos se declaran en tapi3.h.

dwAvailableTracking

Seguimiento disponible, como se representa mediante una LINECALLHUBTRACKING.constant. Este miembro de la estructura solo está disponible si la versión de TAPI negociada es 3.0 o posterior.

Comentarios

Las extensiones específicas del dispositivo deben usar el área de tamaño variable DevSpecific (dwDevSpecificSize y dwDevSpecificOffset) de esta estructura de datos.

Las aplicaciones anteriores se compilan sin miembros nuevos en la estructura LINEDEVCAPS y usan SIZEOF LINEDEVCAPS más pequeños que el nuevo tamaño. La aplicación pasa un parámetro dwAPIVersion con la función lineGetDevCaps , que TAPI puede usar para obtener instrucciones para controlar esta situación. Si la aplicación pasa un miembro dwTotalSize menor que el tamaño de la parte fija de la estructura tal y como se define en dwAPIVersion especificado, se devuelve LINEERR_STRUCTURETOOSMALL. Si la aplicación ha asignado suficiente memoria, antes de llamar a TSPI_lineGetDevCaps, TAPI establece los miembros dwNeededSize y dwUsedSize en el tamaño fijo de la estructura tal como existía en la versión de API especificada.

Las nuevas aplicaciones deben ser conscientes de la versión de api negociada y no examinar el contenido de los miembros de la parte fija más allá del final original de la parte fija de la estructura para la versión de API negociada.

Si el bit de LINEBEARERMODE_DATA se establece en el miembro dwBearerModes , el miembro dwMaxRate indica la velocidad máxima de transmisión digital en el canal de portador. El miembro dwMaxRate de la estructura LINEDEVCAPS puede contener valores válidos aunque el miembro dwBearerModes de la estructura LINEDEVCAPS no esté establecido en LINEBEARERMODE_DATA.

Si LINEBEARERMODE_DATA no se establece en dwBearerModes, pero el valor de LINEBEARERMODE_VOICE se establece y el valor de LINEMEDIAMODE_DATAMODEM se establece en el miembro dwMediaModes , el miembro dwMaxRate indica la velocidad de bits máxima SYNCHRONOUS (DCE) en la línea de teléfono para el módem adjunto o equivalente funcional. Por ejemplo, si la velocidad de modulación más rápida del módem es V.32bis a 14.400bps, dwMaxRate es igual a 14400. Esta no es la velocidad de puerto DTE más rápida (que probablemente sería 38400, 57600 o 115200), pero la velocidad de bits más rápida que admite el módem en la línea de teléfono.

La aplicación debe tener cuidado de comprobar que no se ha establecido LINEBEARERMODE_DATA, para evitar malinterpretar el miembro dwMaxRate . Es probable que sea 64000 o superior si se establece LINEBEARERMODE_DATA.

También debe tenerse en cuenta que si el módem no se ha identificado específicamente (por ejemplo, es un módem "genérico"), la figura indicada es una "mejor estimación" basada en el examen del módem.

Los miembros dwSettableDevStatus a través de dwDeviceClassesOffset solo están disponibles para las aplicaciones que abren el dispositivo de línea con una versión TAPI de 2.0 o posterior.