Condividi tramite

Controllo del dispositivo (API di telefonia)

  • Articolo

Il controllo del dispositivo a livello di applicazione dell'utente finale o del server richiede un set relativamente ridotto di informazioni di base. Il livello di astrazione del provider di servizi esegue il controllo dettagliato del dispositivo. I provider di servizi segnalano le informazioni necessarie sul dispositivo a un'applicazione tramite TAPI.

Le categorie chiave di dispositivo includono:

  • Rete: livello di trasporto per le comunicazioni. Dal punto di vista di un'applicazione, le informazioni sulla rete vengono in genere incorporate nel tipo di indirizzo, ad esempio LINEADDRESSTYPE_PHONENUMBER.
  • Riga: una connessione a una rete. Questo concetto viene ampiamente usato all'interno di TAPI 2.2 (TAPI/C).
  • Canale: suddivisione di una riga. La conoscenza dei canali non è in genere necessaria per un'applicazione perché il provider di servizi configura la modalità di visualizzazione come indirizzi.
  • Indirizzo: percorso di rete in una rete. Ogni riga o canale ha uno o più indirizzi associati. L'indirizzo è un concetto chiave in TAPI 3.1 (TAPI/COM) e TAPI 2.2 (TAPI/C).
  • Terminale: origine o renderer per un indirizzo e un tipo di supporto specifici.

I provider di servizi segnalano le caratteristiche del dispositivo a TAPI in risposta alle query dell'applicazione. I provider di servizi avviano anche report sulle modifiche apportate allo stato del dispositivo. Queste modifiche vengono quindi segnalate a un'applicazione in base alle notifiche richieste durante l'inizializzazione.

Le caratteristiche di base del dispositivo sono:

Inoltre, i provider di servizi forniscono informazioni sulla capacità di un determinato indirizzo per eseguire varie operazioni di sessione.

Le caratteristiche supplementari possono essere associate a determinati dispositivi, se i provider di servizi li supportano. Un'applicazione TAPI 2.x individua le funzionalità usando le funzioni lineGetDevCaps e lineGetAddressCaps . A questo scopo, le applicazioni TAPI 3.x usano l'interfaccia ITAddressCapabilities .

TAPI 2.x offre un set speciale di operazioni supplementari che il provider di servizi può implementare per l'uso con i dispositivi telefonici. Vedi Dispositivi telefonici.

Le funzionalità estese sono specifiche del provider e non sono direttamente coperte dall'API di telefonia Microsoft. Vedere Funzioni line estese, funzioni telefoniche estese o interfacce specifiche del provider.

Di seguito è riportato un riepilogo delle operazioni TAPI che eseguono query sui provider di servizi sulle caratteristiche del dispositivo e forniscono dati sullo stato corrente.

Funzioni TAPI 2.x Descrizione
lineGetDevCaps Esegue una query su un dispositivo linea specificato per determinare le funzionalità di telefonia degli indirizzi associati.
lineGetAddressCaps Esegue una query su un dispositivo linea specificato per determinare le funzionalità di telefonia di un indirizzo specifico.
lineGetDevConfig Restituisce una struttura di dati "opaca" che archivia la configurazione corrente di un dispositivo.
lineSetDevConfig Ripristina la configurazione del dispositivo.
lineConfigDialog Visualizzare una finestra di dialogo che consente all'utente di configurare i parametri correlati al dispositivo.
lineGetID Recupera un identificatore di dispositivo stabile che può essere usato in altre chiamate di funzione TAPI o con un'API diversa.
lineGetLineDevStatus Esegue una query sul dispositivo per ottenere lo stato corrente, ad esempio il numero di chiamate attive.
lineSetLineDevStatus Imposta lo stato del dispositivo, ad esempio l'impostazione di un dispositivo come non nel servizio.
lineGetIcon Recupera l'icona specifica del provider per la visualizzazione all'utente.
lineNegotiateExtVersion Consente a un'applicazione di negoziare una versione dell'estensione da usare con il dispositivo linea specificato.
lineDevSpecific Consente l'accesso alle funzionalità specifiche del dispositivo.
lineDevSpecificFeature Invia funzionalità specifiche del dispositivo al provider di servizi.

 

Interfacce o metodi TAPI 3.x Descrizione
ITAddressCapabilities Ottiene informazioni relative alle funzionalità di un indirizzo.
ITAMMediaFormat Imposta e ottiene il formato multimediale DirectShow™.
ITBasicAudioTerminal Imposta e ottiene le caratteristiche del terminale audio standard, ad esempio il volume.
ITMediaSupport Ottiene informazioni relative alle funzionalità di supporto multimediale di un indirizzo.
ITTerminal Interfaccia di base per l'oggetto Terminal. Ottiene informazioni come la classe terminale e i supporti supportati.
ITTerminalSupport Ottiene informazioni sui terminali disponibili e crea terminali aggiuntivi.
Interfacce specifiche del provider Provider di servizi dipendente.