Función lineMonitorMedia (tapi.h)

Artículo
03/08/2023

La función lineMonitorMedia habilita y deshabilita la detección de tipos de medios (modos) en la llamada especificada. Cuando se detecta un tipo de medio, se envía un mensaje a la aplicación. Para obtener más información, vea ITLegacyCallMediaControl::MonitorMedia.

Sintaxis

LONG lineMonitorMedia(
  HCALL hCall,
  DWORD dwMediaModes
);

Parámetros

hCall

Identificador de la llamada. El estado de llamada de hCall puede ser cualquier estado excepto inactivo.

dwMediaModes

Tipos de medios que se van a supervisar. Si este parámetro es cero, cancela toda la detección de tipos multimedia. Este parámetro usa una o varias de las constantes de LINEMEDIAMODE_.

Valor devuelto

Devuelve cero si la solicitud se realiza correctamente o un número de error negativo si se produce un error. Los valores devueltos posibles son:

LINEERR_INVALCALLHANDLE, LINEERR_OPERATIONUNAVAIL, LINEERR_INVALCALLSTATE, LINEERR_OPERATIONFAILED, LINEERR_INVALMEDIAMODE, LINEERR_RESOURCEUNAVAIL, LINEERR_NOMEM, LINEERR_UNINITIALIZED.

Comentarios

Los tipos de medios especificados con lineOpen solo se relacionan con la habilitación de la detección de estos tipos de medios por parte del proveedor de servicios con el fin de entregar nuevas llamadas entrantes a la aplicación adecuada. No afectan a ninguno de los mensajes de notificación en modo multimedia que se esperan debido a una invocación anterior de lineMonitorMedia.

Esta función se considera correcta si la supervisión de tipos multimedia se ha iniciado correctamente, no cuando la supervisión de tipos multimedia ha finalizado. La supervisión multimedia de un tipo de medio determinado permanece vigente hasta que se deshabilita explícitamente llamando a lineMonitorMedia con un parámetro dwMediaModes establecido en cero, hasta que la llamada pasa a inactiva o cuando la aplicación desasigna su identificador de llamada para la llamada. La función lineMonitorMedia es principalmente un mecanismo de informes de eventos. El tipo de medio (modo) de la llamada, como se indica en LINECALLINFO, no se ve afectado por la detección del tipo de medio del proveedor de servicios. Solo la aplicación de control puede cambiar el tipo de medio de una llamada.

La supervisión de medios predeterminada realizada por el proveedor de servicios corresponde a la unión de todos los tipos de medios especificados en lineOpen.

Aunque esta función se puede invocar en cualquier estado de llamada, el tipo multimedia de una llamada normalmente solo se puede detectar mientras la llamada está en determinados estados de llamada. Estos estados pueden ser específicos del dispositivo. Por ejemplo, en ISDN, un mensaje puede indicar el tipo de medio de la secuencia de medios antes de que exista la secuencia multimedia. De forma similar, el timbre distintivo o la información de identificador llamada sobre la llamada se pueden usar para identificar el tipo de medio de una llamada. De lo contrario, es posible que la llamada tenga que responderse (llamada en estado conectado ) para permitir que un proveedor de servicios determine el tipo de medio de la llamada filtrando la secuencia multimedia. Dado que el filtrado de la secuencia multimedia de una llamada implica una sobrecarga computacional, las aplicaciones deben deshabilitar la supervisión multimedia cuando no sea necesario. De forma predeterminada, la supervisión multimedia está habilitada para las llamadas entrantes recientemente, ya que el tipo de medio de una llamada selecciona la aplicación que debe controlar la llamada.

Una aplicación saliente que se ocupa de los tipos de medios de voz puede querer supervisar la llamada a silencio (un tono) para distinguir quién o qué está en el final de una llamada al que se llama. Por ejemplo, una persona en casa puede responder llamadas con un breve "hola". Una persona de la oficina puede proporcionar un saludo más largo, lo que indica el nombre y el nombre de la compañía. Normalmente, una máquina de respuestas puede tener un saludo aún más largo.

Dado que la detección en modo multimedia habilitada por lineMonitorMedia se implementa como una operación de solo lectura de la secuencia multimedia de la llamada, no es perjudicial.

La supervisión de medios en una llamada de conferencia solo se aplica al parámetro hConfCall , no a las llamadas individuales participantes.