TSPI_lineGetAddressCaps función (tspi.h)

La función TSPI_lineGetAddressCaps consulta la dirección especificada en el dispositivo de línea especificado para determinar sus capacidades de telefonía.

Sintaxis

LONG TSPIAPI TSPI_lineGetAddressCaps(
  DWORD             dwDeviceID,
  DWORD             dwAddressID,
  DWORD             dwTSPIVersion,
  DWORD             dwExtVersion,
  LPLINEADDRESSCAPS lpAddressCaps
);

Parámetros

dwDeviceID

Dispositivo de línea que contiene la dirección que se va a consultar.

dwAddressID

Dirección del dispositivo de línea dado cuyas funcionalidades se van a consultar. Un identificador de dirección está asociado permanentemente a una dirección; el identificador permanece constante en las actualizaciones del sistema operativo. TAPI no valida este parámetro cuando se llama a esta función.

dwTSPIVersion

Número de versión del SPI 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.

dwExtVersion

Número de versión de las extensiones específicas del proveedor de servicios que se van a usar. Este número es 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. TAPI no valida este parámetro cuando se llama a esta función.

lpAddressCaps

Puntero a una estructura de tamaño variable de tipo LINEADDRESSCAPS. Una vez completada correctamente la solicitud, esta estructura se rellena con información de funcionalidades de dirección.

Valor devuelto

Devuelve cero si la función se realiza correctamente o si se produce un error. Los valores devueltos posibles son los siguientes:

LINEERR_INCOMPATIBLEAPIVERSION, LINEERR_NOMEM, LINEERR_INCOMPATIBLEEXTVERSION, LINEERR_OPERATIONUNAVAIL, LINEERR_INVALADDRESSID, LINEERR_OPERATIONFAILED, LINEERR_NODRIVER, LINEERR_RESOURCEUNAVAIL.

Comentarios

Los identificadores de dispositivo de línea admitidos por un controlador determinado se numeran secuencialmente a partir del valor de dwLineDeviceIDBase que se pasa a la función TSPI_providerInit .

El proveedor de servicios rellena todos los miembros de la estructura de datos LINEADDRESSCAPS , excepto dwTotalSize, rellenado por TAPI. El proveedor de servicios no debe sobrescribir el miembro dwTotalSize .

Después de que el proveedor de servicios vuelva de la función TSPI_lineGetAddressCaps , TAPI establece los miembros dwCallInfoStates y dwCallStates de la estructura LINEADDRESSCAPS de la siguiente manera:

LINEADDRESSCAPS.dwCallInfoStates |=
    LINECALLINFOSTATE_NUMOWNERINCR |
    LINECALLINFOSTATE_NUMOWNERDECR |
    LINECALLINFOSTATE_NUMMONITORS;

LINEADDRESSCAPS.dwCallStates |= LINECALLSTATE_UNKNOWN;

Requisitos

Requisito	Value
Plataforma de destino	Windows
Encabezado	tspi.h

Consulte también

LINEADDRESSCAPS

TSPI_providerInit