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

Consulte también

LINEDEVCAPS

LINETERMCAPS

TSPI_lineNegotiateExtVersion

TSPI_lineNegotiateTSPIVersion

TSPI_providerInit