MÉTODO ITLegacyCallMediaControl2::D etectTonesByCollection (tapi3if.h)
El método DetectTonesByCollection habilita y deshabilita la detección de tonos de banda en la llamada. Cada vez que se detecta un tono especificado, se envía un mensaje a la aplicación.
Este método está diseñado para Visual Basic y aplicaciones de scripting. En su lugar, las aplicaciones de C/C++ deben usar el método DetectTones .
Sintaxis
HRESULT DetectTonesByCollection(
[in] ITCollection2 *pDetectToneCollection
);
Parámetros
[in] pDetectToneCollection
Puntero a una interfaz ITCollection2 que contiene una colección de punteros de interfaz ITDetectTone que representan los tonos que se van a supervisar. Cada tono de la lista tiene un campo de etiqueta definido por la aplicación que se usa para identificar los tonos individuales cuando un evento TE_TONEEVENT notifica la detección de tonos. Para obtener más información, vea la sección Comentarios que se muestra más adelante.
Valor devuelto
Este método puede devolver uno de estos valores.
| Código devuelto | Descripción |
|---|---|
|
El método se realizó correctamente. |
|
El parámetro pDetectToneCollection no es un puntero válido. |
|
No hay suficiente memoria para asignar el búfer de tonos. |
|
La llamada debe estar en el estado conectado . |
Comentarios
Este método se traduce en un TAPI 2. xllamada a LineMonitorTones .
Para cancelar la supervisión de tono en curso, llame al método DetectTonesByCollection y especifique una colección vacía. Para cambiar la lista de tonos que se van a supervisar, llame a este método y especifique una nueva colección de tonos.
Requisitos
| Requisito | Value |
|---|---|
| Plataforma de destino | Windows |
| Encabezado | tapi3if.h |
| Library | Uuid.lib |
| Archivo DLL | Tapi3.dll |