funzione lineMonitorMedia (tapi.h)

Articolo
08/26/2023

La funzione lineMonitorMedia abilita e disabilita il rilevamento dei tipi di supporti (modalità) nella chiamata specificata. Quando viene rilevato un tipo di supporto, viene inviato un messaggio all'applicazione. Per altre informazioni, vedere ITLegacyCallMediaControl::MonitorMedia.

Sintassi

LONG lineMonitorMedia(
  HCALL hCall,
  DWORD dwMediaModes
);

Parametri

hCall

Gestire la chiamata. Lo stato della chiamata di hCall può essere qualsiasi stato, ad eccezione dell'inattività.

dwMediaModes

Tipi di supporti da monitorare. Se questo parametro è zero, annulla tutto il rilevamento del tipo di supporto. Questo parametro usa una o più costanti LINEMEDIAMODE_.

Valore restituito

Restituisce zero se la richiesta ha esito positivo o un numero di errore negativo se si verifica un errore. I valori restituiti possibili sono:

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

Commenti

I tipi di supporti specificati con lineOpen si riferiscono solo all'abilitazione del rilevamento di questi tipi di supporti dal provider di servizi allo scopo di distribuire nuove chiamate in ingresso all'applicazione appropriata. Non influiscono sui messaggi di notifica in modalità multimediale previsti a causa di una chiamata precedente di lineMonitorMedia.

Questa funzione viene considerata corretta se il monitoraggio del tipo di supporto è stato avviato correttamente, non quando il monitoraggio del tipo di supporto è terminato. Il monitoraggio multimediale per un determinato tipo di supporto rimane attivo finché non viene disabilitato in modo esplicito chiamando lineMonitorMedia con un parametro dwMediaModes impostato su zero, fino a quando la chiamata passa all'inattività o quando l'applicazione dealloca il relativo handle di chiamata per la chiamata. La funzione lineMonitorMedia è principalmente un meccanismo di segnalazione eventi. Il tipo di supporto (modalità) della chiamata, come indicato in LINECALLINFO, non è interessato dal rilevamento del provider di servizi del tipo di supporto. Solo l'applicazione di controllo può modificare il tipo di supporto di una chiamata.

Il monitoraggio multimediale predefinito eseguito dal provider di servizi corrisponde all'unione di tutti i tipi di supporti specificati in lineOpen.

Anche se questa funzione può essere richiamata in qualsiasi stato di chiamata, il tipo di supporto di una chiamata può in genere essere rilevato solo mentre la chiamata è in determinati stati di chiamata. Questi stati possono essere specifici del dispositivo. Ad esempio, in ISDN, un messaggio può indicare il tipo di supporto del flusso multimediale prima che esista il flusso multimediale. Analogamente, l'anello distintivo o le informazioni sull'identificatore chiamato sulla chiamata possono essere usate per identificare il tipo di supporto di una chiamata. In caso contrario, la chiamata può essere risposta (chiamata nello stato connesso ) per consentire a un provider di servizi di determinare il tipo di supporto della chiamata filtrando il flusso multimediale. Poiché il filtro del flusso multimediale di una chiamata implica un sovraccarico di calcolo, le applicazioni devono disabilitare il monitoraggio multimediale quando non necessario. Per impostazione predefinita, il monitoraggio multimediale è abilitato per le chiamate appena in ingresso, perché il tipo di supporto di una chiamata seleziona l'applicazione che deve gestire la chiamata.

Un'applicazione in uscita che gestisce i tipi di supporti vocali può voler monitorare la chiamata al silenzio (un tono) per distinguere chi o cosa è alla fine di una chiamata. Ad esempio, una persona a casa può rispondere alle chiamate con solo un breve "hello". Una persona dell'ufficio può fornire un saluto più lungo, che indica il nome e il nome della società. Un computer di risposta può in genere avere un saluto ancora più lungo.

Poiché il rilevamento in modalità multimediale abilitato da lineMonitorMedia viene implementato come operazione di sola lettura del flusso multimediale della chiamata, non è dirompente.

Il monitoraggio dei supporti in una chiamata di conferenza si applica solo al parametro hConfCall , non alle singole chiamate che partecipano.