Delen via


Apparaatbeheer (Telefonie-API)

Apparaatbeheer op het niveau van de eindgebruiker of servertoepassing vereist een relatief kleine set basisinformatie. De abstractielaag van de serviceprovider voert gedetailleerd apparaatbeheer uit. De serviceproviders rapporteren vereiste apparaatgegevens aan een toepassing via TAPI.

Belangrijke apparaatcategorieën zijn:

  • Network: de transportlaag voor communicatie. Vanuit het oogpunt van een toepassing wordt informatie over het netwerk doorgaans ingesloten in het adrestype, zoals LINEADDRESSTYPE_PHONENUMBER.
  • regel: een verbinding met een netwerk. Dit concept wordt intensief gebruikt binnen TAPI 2.2 (TAPI/C).
  • Kanaal: Een onderverdeling van een regel. Kennis van kanalen is normaal gesproken niet vereist voor een toepassing, omdat de serviceprovider configureert hoe deze worden weergegeven als adressen.
  • adres: een netwerklocatie op een netwerk. Elke regel of elk kanaal heeft een of meer gekoppelde adressen. Het adres is een belangrijk concept in zowel TAPI 3.1 (TAPI/COM) als TAPI 2.2 (TAPI/C).
  • Terminal-: een bron of renderer voor een bepaald adres en mediatype.

De serviceproviders rapporteren apparaatkenmerken aan TAPI als reactie op toepassingsquery's. Serviceproviders initiëren ook rapporten over wijzigingen in de apparaatstatus. Deze wijzigingen worden vervolgens gerapporteerd aan een toepassing op basis van de meldingen die tijdens de initialisatie zijn aangevraagd.

Basiskenmerken van apparaten zijn:

Daarnaast leveren de dienstverleners informatie over de capaciteit van een bepaald adres om verschillende sessiebewerkingen uit te voeren.

Aanvullende kenmerken kunnen worden gekoppeld aan bepaalde apparaten, als de serviceproviders deze ondersteunen. Een TAPI 2.x-toepassing detecteert mogelijkheden met behulp van de functies lineGetDevCaps en lineGetAddressCaps. TAPI 3.x-toepassingen gebruiken hiervoor de ITAddressCapabilities interface.

TAPI 2.x biedt een speciale set aanvullende bewerkingen die de serviceprovider kan implementeren voor gebruik met telefoonapparaten. Zie Telefoonapparaten.

Uitgebreide mogelijkheden zijn providerspecifiek en niet rechtstreeks gedekt door de Microsoft Telefonie-API. Zie Extended Line Functions, Extended Telephony Phone Functionsof Provider-Specific Interfaces.

Hieronder ziet u een samenvatting van TAPI-bewerkingen waarmee serviceproviders op apparaatkenmerken worden opvraagt en gegevens over de huidige status opgeven.

TAPI 2.x-functies Beschrijving
lineGetDevCaps- Hiermee wordt een query uitgevoerd op een opgegeven lijnapparaat om de telefoniemogelijkheden van gekoppelde adressen te bepalen.
lineGetAddressCaps- Query's uitvoeren op een opgegeven lijnapparaat om de telefoniemogelijkheden van een specifiek adres te bepalen.
lineGetDevConfig- Retourneert een 'ondoorzichtige' gegevensstructuur waarin de huidige configuratie van een apparaat wordt opgeslagen.
lineSetDevConfig- Hiermee herstelt u de apparaatconfiguratie.
lineConfigDialog- Een dialoogvenster weergeven waarmee de gebruiker parameters kan configureren die betrekking hebben op het apparaat.
lineGetID- Haalt een stabiele apparaat-id op die kan worden gebruikt in verdere TAPI-functie-aanroepen of met een andere API.
lineGetLineDevStatus Hiermee wordt een apparaat opgevraagd voor de huidige status, zoals het aantal actieve aanroepen.
lineSetLineDevStatus- Hiermee stelt u de apparaatstatus in, zoals het instellen van een apparaat als niet in de service.
lineGetIcon- Hiermee haalt u het providerspecifieke pictogram op voor weergave aan de gebruiker.
lineNegotiateExtVersion Hiermee kan een toepassing onderhandelen over een extensieversie die kan worden gebruikt met het opgegeven regelapparaat.
lineDevSpecific- Biedt toegang tot apparaatspecifieke functies.
lineDevSpecificFeature- Hiermee worden apparaatspecifieke functies naar de serviceprovider verzonden.

 

TAPI 3.x-interfaces of -methoden Beschrijving
ITAddressCapabilities- Hiermee haalt u informatie op over de mogelijkheden van een adres.
ITAMMediaFormat- Hiermee stelt u de DirectShow-media-indeling™ in en haalt u deze op.
ITBasicAudioTerminal Hiermee stelt u standaard audioterminalkenmerken in, zoals volume.
ITMediaSupport- Hiermee wordt informatie opgehaald over de mediaondersteuningsmogelijkheden van een adres.
ITTerminal Basisinterface voor het Terminal-object. Haalt informatie op, zoals terminalklasse en media die worden ondersteund.
ITTerminalSupport- Haalt informatie op over de beschikbare terminals en maakt extra terminals.
Provider-Specific interfaces Afhankelijk van serviceprovider.