Classi di dispositivi TAPI

Una classe di dispositivi è un gruppo di dispositivi fisici o driver di dispositivo correlati tramite cui le applicazioni inviano e ricevono le informazioni o i dati che costituiscono una chiamata. Ogni classe del dispositivo ha un nome di classe di dispositivo che identifica in modo univoco la classe e fornisce informazioni sull'interfaccia di programmazione e sui comandi che possono essere usati per aprire e comunicare con i dispositivi nella classe .

Il TAPI (Telephony Application Programming Interface) associa i dispositivi da una o più classi di dispositivi a ogni linea o dispositivo telefonico. È possibile accedere a uno di questi dispositivi recuperando l'identificatore del dispositivo per il dispositivo usando la funzione lineGetID o phoneGetID . Specificare il nome della classe del dispositivo e la funzione restituisce il nome della porta, il nome del dispositivo, l'handle del dispositivo o l'identificatore del dispositivo che è necessario aprire e accedere al dispositivo. Il formato delle informazioni restituite dipende dalla classe del dispositivo e viene descritto negli argomenti successivi di questa sezione.

È anche possibile usare i nomi delle classi di dispositivo con le funzioni lineConfigDialog e phoneConfigDialog per consentire all'utente di impostare le opzioni di configurazione per il dispositivo specificato, con le funzioni lineGetIcon e phoneGetIcon per recuperare un'icona per rappresentare il dispositivo specificato e con le funzioni lineGetDevConfig e lineSetDevConfig per recuperare e impostare direttamente le opzioni di configurazione per il dispositivo specificato.

L'elenco seguente mostra i nomi delle classi di dispositivo.

Nome classe dispositivo Descrizione
Comm Porta di comunicazione.
comm/datamodem Modem attraverso una porta di comunicazione.
comm/datamodem/portname Nome del dispositivo a cui è connesso un modem.
onda/in Dispositivo audio wave (solo input).
onda/uscita Dispositivo audio wave (solo output).
onda/in/uscita Dispositivo audio wave, full duplex.
midi/in Sequencer MIDI (solo input).
midi/out MIDI Sequencer (solo output).
tapi/line Dispositivo linea.
tapi/telefono Dispositivo telefonico.
Ndis Dispositivo di rete.
tapi/terminale Dispositivo terminale.

 

Nota

Questi nomi non fanno distinzione tra maiuscole e minuscole; è possibile utilizzare qualsiasi combinazione di lettere maiuscole e minuscole.

 

È possibile che in un sistema specifico siano disponibili classi di dispositivi e nomi di classi di dispositivi aggiuntivi. In generale, se un dispositivo non appartiene a una delle classi di dispositivo predefinite, il produttore definisce in genere una nuova classe di dispositivo e assegna un nome univoco della classe di dispositivo. Controllare la documentazione relativa al dispositivo per determinare quali classi di dispositivi aggiuntive sono disponibili. Si noti, tuttavia, che anche se la classe del dispositivo e il tipo di supporto sono correlati, non sono uguali. Un tipo di supporto descrive il formato delle informazioni sulle chiamate e una classe di dispositivo definisce l'interfaccia di programmazione usata per gestire tali informazioni. Pertanto, anche se un produttore definisce un nuovo tipo di supporto, non è necessariamente vero che il produttore deve anche definire una nuova classe di dispositivo per supportare la modalità.

Il formato dei dati di configurazione usati con le funzioni lineSetDevConfig e lineGetDevConfig dipende anche dalla classe del dispositivo. In generale, si usa lineGetDevConfig per salvare una copia dei dati di configurazione del dispositivo corrente e quindi usare lineSetDevConfig con i dati di configurazione salvati per ripristinare la configurazione del dispositivo allo stato precedente. Si tratta di un modo pratico per modificare temporaneamente la configurazione senza richiedere all'utente di ripristinarla manualmente nello stato precedente. Poiché il formato esatto dei dati di configurazione del dispositivo può essere diverso con ogni provider di servizi, non è consigliabile usare lineSetDevConfig e lineGetDevConfig per modificare direttamente i dati di configurazione del dispositivo. Alcuni formati vengono forniti solo per informazioni.