TAPI-enhetsklasser

En enhetsklass är en grupp relaterade fysiska enheter eller enhetsdrivrutiner genom vilka program skickar och tar emot den information eller de data som utgör ett anrop. Varje enhetsklass har ett enhetsklassnamn som unikt identifierar klassen och innehåller information om programmeringsgränssnittet och kommandon som kan användas för att öppna och kommunicera med enheterna i klassen.

TAPI (Telephony Application Programming Interface) associerar enheter från en eller flera enhetsklasser till varje rad- eller telefonenhet. Du kommer åt någon av dessa enheter genom att hämta enhetsidentifieraren för enheten med hjälp av lineGetID eller phoneGetID-funktion. Du anger enhetsklassnamnet och funktionen returnerar det specifika portnamn, enhetsnamn, enhetshandtag eller enhetsidentifierare som du behöver för att öppna och komma åt enheten. Formatet på den information som returneras beror på enhetsklassen och beskrivs i efterföljande avsnitt i det här avsnittet.

Du använder också enhetsklassnamn med lineConfigDialog och phoneConfigDialog-funktioner för att göra det möjligt för användaren att ange konfigurationsalternativ för den angivna enheten. med lineGetIcon och phoneGetIcon funktioner för att hämta en ikon för att representera den angivna enheten, och med lineGetDevConfig och lineSetDevConfig funktioner för att hämta och ange direkt konfigurationsalternativ för den angivna enheten.

I följande lista visas enhetsklassnamn.

Enhetsklassnamn	Beskrivning
komma	Kommunikationsport.
comm/datamodem	Modem via en kommunikationsport.
comm/datamodem/portname	Namnet på enheten som ett modem är anslutet till.
våg/i	Wave-ljudenhet (endast indata).
våg/ut	Wave-ljudenhet (endast utdata).
våg/in/ut	Wave-ljudenhet, full duplex.
midi/in	MIDI-sekvenserare (endast indata).
midi/out	MIDI-sekvenserare (endast utdata).
tapi/rad	Linjeenhet.
tapi/telefon	Telefonenhet.
ndis	Nätverksenhet.
tapi/terminal	Terminalenhet.

 

Not

Dessa namn är inte skiftlägeskänsliga. du kan använda valfri kombination av versaler och gemener.

 

Ytterligare enhetsklasser och enhetsklassnamn kan vara tillgängliga i ett visst system. Om en enhet i allmänhet inte tillhör någon av standardenhetsklasserna definierar tillverkaren vanligtvis en ny enhetsklass och tilldelar ett unikt enhetsklassnamn. Kontrollera dokumentationen för enheten för att avgöra vilka ytterligare enhetsklasser som är tillgängliga för den. Observera dock att även om enhetsklassen och medietypen är relaterade är de inte desamma. En medietyp beskriver anropsinformationsformatet, och en enhetsklass definierar det programmeringsgränssnitt som används för att hantera den informationen. Så även om en tillverkare definierar en ny medietyp är det inte nödvändigtvis sant att tillverkaren också behöver definiera en ny enhetsklass för att stödja läget.

Formatet på konfigurationsdata som används med lineSetDevConfig och lineGetDevConfig funktioner beror också på enhetsklassen. I allmänhet använder du lineGetDevConfig för att spara en kopia av aktuella enhetskonfigurationsdata och sedan använda lineSetDevConfig med sparade konfigurationsdata för att återställa enhetskonfigurationen till föregående tillstånd. Det här är ett praktiskt sätt att tillfälligt ändra konfigurationen utan att användaren behöver återställa den till föregående tillstånd manuellt. Eftersom det exakta formatet för enhetskonfigurationsdata kan vara olika för varje tjänstleverantör bör du inte använda lineSetDevConfig och radGetDevConfig för att manipulera enhetskonfigurationsdata direkt. Vissa format tillhandahålls endast för information.