TSPI_lineGetDevCaps función (tspi.h)
La función TSPI_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 TSPIAPI TSPI_lineGetDevCaps(
DWORD dwDeviceID,
DWORD dwTSPIVersion,
DWORD dwExtVersion,
LPLINEDEVCAPS lpLineDevCaps
);
Parámetros
dwDeviceID
Dispositivo de línea que se va a consultar.
dwTSPIVersion
Número de versión de TSPI negociado. Este valor ya se ha negociado para este dispositivo a través de la función TSPI_lineNegotiateTSPIVersion .
dwExtVersion
Número de versión de la extensión negociada. Este valor ya se ha negociado para este dispositivo a través de la función TSPI_lineNegotiateExtVersion . TAPI no valida este parámetro cuando se llama a esta función.
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 de funcionalidades del dispositivo de línea.
Valor devuelto
Devuelve cero si la función se realiza correctamente o un número de error si se produce un error. Los valores devueltos posibles son los siguientes:
LINEERR_INCOMPATIBLEAPIVERSION, LINEERR_OPERATIONUNAVAIL, LINEERR_INCOMPATIBLEEXTVERSION, LINEERR_OPERATIONFAILED, LINEERR_NODRIVER, LINEERR_RESOURCEUNAVAIL, LINEERR_NOMEM.
Comentarios
La numeración de identificador de dispositivo de línea para un proveedor de servicios es secuencial del valor establecido por el parámetro dwLineDeviceIDBase que se pasa a la función TSPI_providerInit .
El parámetro formal dwExtVersion indica el número de versión de la información de extensión solicitada. Si es cero, no se solicita información de extensión. Si no es cero, contiene un valor negociado para este dispositivo con la función TSPI_lineNegotiateExtVersion . El proveedor de servicios rellena información extendida específica del dispositivo y del proveedor según la versión de extensión especificada.
El proveedor de servicios rellena todos los miembros de la estructura de datos LINEDEVCAPS , excepto dwTotalSize, rellenado por TAPI. El proveedor de servicios no debe sobrescribir el miembro dwTotalSize .
El proveedor de servicios debe rellenar todos los miembros de la estructura de datos LINETERMCAPS o estructuras incrustadas en la parte variable de la estructura de datos LINEDEVCAPS .
Después de que el proveedor de servicios vuelva de la función TSPI_lineGetDevCaps , TAPI establece el miembro dwLinesStates de la estructura LINEDEVCAPS de la siguiente manera:
LINEDEVCAPS.dwLineStates |=
LINEDEVSTATE_OPEN |
LINEDEVSTATE_CLOSE |
LINEDEVSTATE_REINIT |
LINEDEVSTATE_TRANSLATECHANGE;
Requisitos
| Requisito | Value |
|---|---|
| Plataforma de destino | Windows |
| Encabezado | tspi.h |