Función lineGetDevCaps (tapi.h)

Artículo
08/26/2023

La función lineGetDevCaps consulta un dispositivo de línea especificado para determinar sus funcionalidades de telefonía. La información devuelta es válida para todas las direcciones del dispositivo de línea.

Sintaxis

LONG lineGetDevCaps(
  HLINEAPP      hLineApp,
  DWORD         dwDeviceID,
  DWORD         dwAPIVersion,
  DWORD         dwExtVersion,
  LPLINEDEVCAPS lpLineDevCaps
);

Parámetros

hLineApp

Controle el registro de la aplicación con TAPI.

dwDeviceID

Identificador del dispositivo de línea que se va a consultar.

dwAPIVersion

Número de versión de la API de telefonía que se va a usar. La palabra de orden superior contiene el número de versión principal; la palabra de orden bajo contiene el número de versión secundaria. Este número se obtiene mediante lineNegotiateAPIVersion.

dwExtVersion

Número de versión de las extensiones específicas del proveedor de servicios que se van a usar. Este número se obtiene mediante lineNegotiateExtVersion. Puede dejar cero si no se van a usar extensiones específicas del dispositivo. De lo contrario, la palabra de orden superior contiene el número de versión principal; la palabra de orden bajo contiene el número de versión secundaria.

lpLineDevCaps

Puntero a una estructura de tamaño variable de tipo LINEDEVCAPS. Una vez completada correctamente la solicitud, esta estructura se rellena con información sobre las funcionalidades del dispositivo de línea. Antes de llamar a lineGetDevCaps, la aplicación debe establecer el miembro dwTotalSize de esta estructura para indicar la cantidad de memoria disponible para TAPI para devolver información.

Nota Si los parámetros de tamaño de la estructura no son correctos, existe la posibilidad de que se sobrescriban los datos. Para obtener más información sobre cómo establecer tamaños de estructura, consulte el tema de asignación de memoria .

Valor devuelto

Devuelve cero si la solicitud se realiza correctamente o un número de error negativo si se produce un error. Los valores devueltos posibles son:

LINEERR_BADDEVICEID, LINEERR_NOMEM, LINEERR_INCOMPATIBLEAPIVERSION, LINEERR_OPERATIONFAILED, LINEERR_INCOMPATIBLEEXTVERSION, LINEERR_RESOURCEUNAVAIL, LINEERR_INVALAPPHANDLE, LINEERR_STRUCTURETOOSMALL, LINEERR_INVALPOINTER, LINEERR_UNINITIALIZED, LINEERR_NODRIVER, LINEERR_OPERATIONUNAVAIL, LINEERR_NODEVICE.

Comentarios

Antes de usar lineGetDevCaps, la aplicación debe negociar el número de versión de la API que se va a usar y, si lo desea, la versión de la extensión que se va a usar.

Los números de versión de la API y la extensión son los que deben funcionar TAPI y el proveedor de servicios. Si los intervalos de versiones no se superponen, la aplicación, la API o las versiones del proveedor de servicios son incompatibles y se devuelve un error.

Uno de los miembros de la estructura LINEDEVCAPS devuelta por esta función contiene el número de direcciones asignadas al dispositivo de línea especificado. Los identificadores de dirección reales que se usan para hacer referencia a direcciones individuales varían de cero a uno menor que el número devuelto. Las funcionalidades de cada dirección pueden ser diferentes. Use lineGetAddressCaps para cada combinación dwDeviceID, dwAddressID> disponible < para determinar las funcionalidades exactas de cada dirección. Tenga en cuenta que un identificador de dirección está asociado permanentemente a una dirección; el identificador permanece constante en las actualizaciones del sistema operativo.