TSPI_lineSetDefaultMediaDetection función (tspi.h)
El procedimiento TSPI_lineSetDefaultMediaDetection indica al proveedor de servicios el nuevo conjunto de tipos de medios que detecte para la línea indicada (reemplazando cualquier conjunto anterior). También establece el conjunto inicial de tipos de medios que se deben supervisar en llamadas posteriores (entrantes o salientes) en esta línea.
Sintaxis
LONG TSPIAPI TSPI_lineSetDefaultMediaDetection(
HDRVLINE hdLine,
DWORD dwMediaModes
);
Parámetros
hdLine
Identificador de la línea para que se establezca la supervisión multimedia.
dwMediaModes
Tipos de medios de interés para TAPI. Este parámetro usa una de las constantes LINEMEDIAMODE_:
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_INVALLINEHANDLE, LINEERR_OPERATIONFAILED, LINEERR_INVALMEDIAMODE, LINEERR_RESOURCEUNAVAIL, LINEERR_NOMEM, LINEERR_NODRIVER, LINEERR_OPERATIONUNAVAIL.
Comentarios
TAPI normalmente llama a esta función para actualizar el conjunto de tipos de medios detectados para la línea a la unión de todos los modos seleccionados por todas las líneas pendientesAbrir cada vez que se abre o se cierra una línea en el nivel TAPI. Se rechaza un intento de llamada lineOpen si se rechaza la detección de medios. Normalmente, una sola llamada a este procedimiento es el resultado de una llamada lineOpen que no especifica el identificador de dispositivo LINEMAPPER. El identificador de dispositivo LINEMAPPER nunca se usa en el nivel de TSPI.
TAPI debe calcular la unión de tipos de medios deseados por todos los clientes y pasar el resultado a esta función. El proveedor de servicios usa el conjunto pasado a esta función por TAPI. TAPI garantiza que el parámetro dwMediaModes tenga al menos un conjunto de bits y que no se establezcan bits reservados. El proveedor de servicios debe realizar comprobaciones de validez adicionales en los tipos de medios, como comprobar si algún tipo de medio es compatible con el proveedor de servicios. La unión de todos los tipos de medios puede ser el valor 0 si las aplicaciones que tienen abierta la línea son monitores o no interesados en controlar las llamadas entrantes.
No hay ninguna función correspondiente directamente en el nivel TAPI. Este procedimiento corresponde a los "tipos de medios de solicitud" implícitos para la línea específica por el procedimiento lineOpen cuando se llama con el identificador de dispositivo específico (distinto de LINEMAPPER).
Requisitos
| Requisito | Value |
|---|---|
| Plataforma de destino | Windows |
| Encabezado | tspi.h |