Función phoneGetDevCaps (tapi.h)

Artículo
03/08/2023

La función phoneGetDevCaps consulta un dispositivo telefónico especificado para determinar sus funcionalidades de telefonía.

Sintaxis

LONG phoneGetDevCaps(
  HPHONEAPP   hPhoneApp,
  DWORD       dwDeviceID,
  DWORD       dwAPIVersion,
  DWORD       dwExtVersion,
  LPPHONECAPS lpPhoneCaps
);

Parámetros

hPhoneApp

Controle el registro de la aplicación con TAPI.

dwDeviceID

Identificador del dispositivo telefónico 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 con la función phoneNegotiateAPIVersion.

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 con la función phoneNegotiateExtVersion. Se puede dejar 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.

lpPhoneCaps

Puntero a una estructura de tamaño variable de tipo PHONECAPS. Una vez completada correctamente la solicitud, esta estructura se rellena con información de funcionalidades del dispositivo telefónico.

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:

PHONEERR_INVALAPPHANDLE, PHONEERR_INVALPOINTER, PHONEERR_BADDEVICEID, PHONEERR_OPERATIONFAILED, PHONEERR_INCOMPATIBLEAPIVERSION, PHONEERR_OPERATIONUNAVAIL, PHONEERR_INCOMPATIBLEEXTVERSION, PHONEERR_NOMEM, PHONEERR_STRUCTURETOOSMALL, PHONEERR_RESOURCEUNAVAIL, PHONEERR_NODRIVER, PHONEERR_UNINITIALIZED, PHONEERR_NODEVICE.

Comentarios

Antes de usar phoneGetDevCaps, la aplicación debe negociar el número de versión tapi que se usará (consulte phoneNegotiateAPIVersion) y, opcionalmente, la versión de extensión que se va a usar (consulte phoneNegotiateExtVersion).

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