función TSPI_lineSelectExtVersion (tspi.h)
La función TSPI_lineSelectExtVersion selecciona la versión de extensión indicada para el dispositivo de línea indicado. Las solicitudes posteriores funcionan según esa versión de extensión.
Sintaxis
LONG TSPIAPI TSPI_lineSelectExtVersion(
HDRVLINE hdLine,
DWORD dwExtVersion
);
Parámetros
hdLine
Identificador de la línea para la que se va a seleccionar una versión de extensión.
dwExtVersion
Versión de extensión que se va a seleccionar. Este número de versión se ha negociado mediante TSPI_lineNegotiateExtVersion. El WORD más significativo es el número de versión principal y el número de versión menor de WORD es el número de versión secundaria. Al llamar a esta función con dwExtVersion de cero, se cancela la selección actual.
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:
LINEERR_INCOMPATIBLEEXTVERSION, LINEERR_OPERATIONFAILED, LINEERR_NOMEM, LINEERR_RESOURCEUNAVAIL, LINEERR_OPERATIONUNAVAIL.
Comentarios
El proveedor de servicios selecciona la versión de extensión indicada. Aunque es posible que el número de versión indicado se haya negociado correctamente, es posible que se haya seleccionado una versión de extensión diferente mientras tanto, en cuyo caso se produce un error en esta función (se devuelve LINEERR_INCOMPATIBLEEXTVERSION).
Las operaciones posteriores en la línea después de seleccionar una versión de extensión se comportan según esa versión de extensión. Los intentos posteriores de negociar la versión de extensión notifican estrictamente la versión seleccionada o 0 (si el intervalo solicitado no incluye la versión seleccionada). Al llamar a este procedimiento con la versión 0 de extensión especial, se cancela la selección actual. El dispositivo vuelve a ser capaz de admitir su gama completa de números de versión de extensión.
Esta función no tiene correspondencia directa en el nivel TAPI, donde la selección de una versión de extensión se incluye con la otra funcionalidad de lineOpen. La función TSPI_lineSelectExtVersion suele llamarse en dos situaciones: (1) Una aplicación solicitó abrir una línea, el cambio resultante de la supervisión de tipos multimedia se realizó correctamente, la aplicación solicitó que se usara una versión de extensión determinada y que no se seleccionara ninguna versión de extensión. (2) La última aplicación que usa una versión de extensión determinada cerró la línea y se puede cancelar la selección de la versión de la extensión.
Requisitos
| Requisito | Value |
|---|---|
| Plataforma de destino | Windows |
| Encabezado | tspi.h |