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 |