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 |