Función lineGetDevCapsA (tapi.h)

La lineGetDevCaps función 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 lineGetDevCapsA(
  HLINEAPP      hLineApp,
  DWORD         dwDeviceID,
  DWORD         dwAPIVersion,
  DWORD         dwExtVersion,
  LPLINEDEVCAPS lpLineDevCaps
);

Parámetros

hLineApp

Controlar 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 dejarse cero si no se va a usar ninguna extensión específica 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. Tras completar correctamente la solicitud, esta estructura se rellena con información de funcionalidades del dispositivo de línea. Antes de llamar a lineGetDevCaps, la aplicación debe establecer el dwTotalSize miembro 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 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.

Observaciones

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 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 LINEDEVCAPS estructura 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 <dwDeviceID, combinación de> dwAddressID 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.

Nota

El encabezado tapi.h define lineGetDevCaps como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o tiempo de ejecución. Para obtener más información, vea Conventions for Function Prototypes.

Requisitos

Requisito	Valor
de la plataforma de destino de	Windows
encabezado de	tapi.h
biblioteca de	Tapi32.lib
DLL de	Tapi32.dll

Consulte también

referencia de servicios de telefonía básica de

LINEDEVCAPS

de información general de referencia de TAPI 2.2

lineGetAddressCaps

lineNegotiateAPIVersion

lineNegotiateExtVersion