TSPI-apparaatklassen

Een apparaatklasse is een groep gerelateerde fysieke apparaten of apparaatstuurprogramma's waarmee toepassingen de informatie of gegevens verzenden en ontvangen die een oproep vormen. Elke apparaatklasse heeft een naam van de apparaatklasse die de klasse uniek identificeert en informatie biedt over de programmeerinterface en opdrachten die kunnen worden gebruikt om de apparaten in de klasse te openen en te communiceren.

De TAPI (Telephony Application Programming Interface) koppelt apparaten van een of meer apparaatklassen aan elke lijn of elk telefoonapparaat. U opent een van deze apparaten door de apparaat-id voor het apparaat op te halen met behulp van de functie lineGetID of phoneGetID. U geeft de naam van de apparaatklasse op en de functie retourneert de specifieke poortnaam, apparaatnaam, apparaatgreep of apparaat-id die u nodig hebt om het apparaat te openen en te openen. De indeling van de geretourneerde informatie is afhankelijk van de apparaatklasse en wordt beschreven in deze sectie.

U gebruikt ook apparaatklassenamen met de functies lineConfigDialog en phoneConfigDialog om de gebruiker in staat te stellen configuratieopties voor het opgegeven apparaat in te stellen; met de functies lineGetIcon en phoneGetIcon om een pictogram op te halen dat het opgegeven apparaat vertegenwoordigt; en met de lineGetDevConfig-- en lineSetDevConfig-functies voor het rechtstreeks ophalen en instellen van configuratieopties voor het opgegeven apparaat.

Hieronder volgen de standaardnamen van apparaatklassen.

Naam van apparaatklasse	Beschrijving
comm	Communicatiepoort
comm/datamodem-	Modem via een communicatiepoort
comm/datamodem/portname	Naam van het apparaat waarop een modem is aangesloten
golf/in	Wave-audioapparaat (alleen invoer)
	Wave-audioapparaat (alleen uitvoer)
golf/in/uit	Golfaudioapparaat, full duplex
midi/in	MIDI Sequencer (alleen invoer)
midi/out	MIDI sequencer (alleen uitvoer)
tapi/regel	Lijnapparaat
tapi/telefoon	Telefoonapparaat
	Netwerkapparaat
tapi/terminal-	Terminalapparaat

 

Deze namen zijn niet hoofdlettergevoelig, dus u kunt elke combinatie van hoofdletters en kleine letters gebruiken.

Er kunnen extra apparaatklassen en apparaatklassenamen beschikbaar zijn op een bepaald systeem. Als een apparaat niet tot een van de standaardapparaatklassen behoort, definieert de fabrikant doorgaans een nieuwe apparaatklasse en wijst een unieke apparaatklassenaam toe. U moet de documentatie voor het apparaat controleren om te bepalen welke extra apparaatklassen er beschikbaar zijn. Houd er echter rekening mee dat hoewel de apparaatklasse en het mediatype zijn gerelateerd, ze niet hetzelfde zijn. Een mediatype beschrijft een indeling van informatie over een oproep en een apparaatklasse definieert de programmeerinterface die wordt gebruikt om die informatie te beheren. Dus zelfs als een fabrikant een nieuw mediatype definieert, is het mogelijk niet waar dat de fabrikant ook een nieuwe apparaatklasse moet definiëren ter ondersteuning van de modus.

De indeling van de configuratiegegevens die worden gebruikt met de lineSetDevConfig-- en lineGetDevConfig--functies is ook afhankelijk van de apparaatklasse. Over het algemeen gebruikt u lineGetDevConfig- om een kopie van de huidige apparaatconfiguratiegegevens op te slaan en gebruikt u later lineSetDevConfig- met de opgeslagen configuratiegegevens om de apparaatconfiguratie te herstellen naar de vorige status. Dit is een handige manier om de configuratie tijdelijk te wijzigen zonder dat de gebruiker deze handmatig moet herstellen naar de vorige status. Omdat de exacte indeling van de apparaatconfiguratiegegevens bij elke serviceprovider kan verschillen, gebruikt u niet lineSetDevConfig- en lineGetDevConfig- om de apparaatconfiguratiegegevens rechtstreeks te bewerken. Sommige indelingen zijn alleen beschikbaar voor informatie.