función TSPI_phoneGetDevCaps (tspi.h)

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

Sintaxis

LONG TSPIAPI TSPI_phoneGetDevCaps(
  DWORD       dwDeviceID,
  DWORD       dwTSPIVersion,
  DWORD       dwExtVersion,
  LPPHONECAPS lpPhoneCaps
);

Parámetros

dwDeviceID

Dispositivo telefónico que se va a consultar.

dwTSPIVersion

Número de versión de TSPI negociado. Este valor se negocia para este dispositivo a través de la función TSPI_phoneNegotiateTSPIVersion .

dwExtVersion

Número de versión de la extensión negociada. Este valor se negocia para este dispositivo a través de la función TSPI_phoneNegotiateExtVersion .

lpPhoneCaps

Puntero a la memoria en la que el proveedor de servicios escribe una estructura de tamaño variable de tipo PHONECAPS. Tras completar correctamente la solicitud, esta estructura se rellena con información de funcionalidad del dispositivo telefónico. Antes de llamar a TSPI_phoneGetDevCaps, la aplicación establece el miembro dwTotalSize de esta estructura para indicar la cantidad de memoria disponible para TAPI para devolver información.

Valor devuelto

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

PHONEERR_INCOMPATIBLEAPIVERSION, PHONEERR_RESOURCEUNAVAIL, PHONEERR_INCOMPATIBLEEXTVERSION, PHONEERR_OPERATIONFAILED, PHONEERR_NODRIVER, PHONEERR_OPERATIONUNAVAIL, PHONEERR_NOMEM.

Comentarios

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

Si dwExtVersion es cero, no se solicita información de extensión. Si no es cero, contiene un valor que ya se ha negociado para este dispositivo con la función TSPI_phoneNegotiateExtVersion . El proveedor de servicios rellena la información extendida específica del dispositivo y del proveedor según la versión de extensión especificada.

Después de que el proveedor de servicios vuelva de la función TSPI_phoneGetDevCaps , TAPI establece el miembro dwPhoneStates de la estructura PHONECAPS de la siguiente manera:

PHONECAPS.dwPhoneStates |=
    PHONESTATE_OWNER |
    PHONESTATE_MONITORS |
    PHONESTATE_REINIT;

Requisitos

Requisito	Value
Plataforma de destino	Windows
Encabezado	tspi.h

Consulte también

PHONEBUTTONINFO

PHONECAPS

TSPI_phoneNegotiateExtVersion