Benutzerhandbuch für Intel 05-2409-003

Inhaltsverzeichnis

• Global Call API for Host Media Processing on Windows

  1
  • Contents

    3
• Figures

  7
• Tables

  9
• Revision History

  11
  • Call Control Libraries section

    11
  • Using Protocols (Flexible Routing) section

    11
  • Setting Call Analysis Attributes on a Per Call Basis section

    11
  • Debugging chapter

    11
  • Global change

    11
  • Global change

    11
  • Starting Call Control Libraries section

    11
  • Overlap Sending section

    11
  • Configuring Default Call Progress Analysis Parameters section

    11
  • Real Time Configuration Management chapter

    11
  • Supervised Transfers section

    11
• About This Publication

  13
• 1. Product Description

  17
  • 1.1 Global Call Software Overview

    17
  • 1.2 Global Call Feature Categories

    18
    • 1.2.1 Call Control Features

      18
    • 1.2.2 Operation, Administration and Maintenance Features

      18
  • 1.3 Global Call Architecture

    19
    • 1.3.1 Overview

      19
    • 1.3.2 Global Call API

      21
  • 1.4 Call Control Libraries

    22
    • 1.4.1 Starting Call Control Libraries

      22
    • 1.4.2 Call Control Library States

      22
  • 1.5 Global Call Object Identifiers

    23
    • 1.5.1 Line Device Identifier

      24
    • 1.5.2 Call Reference Number

      24
    • 1.5.3 Object Identifiers and Resource Sharing Across Processes

      25
    • 1.5.4 Target Objects

      25
• 2. Programming Models

  29
  • 2.1 Programming Models Overview

    29
  • 2.2 Asynchronous Mode Programming

    29
    • 2.2.1 Asynchronous Model Overview

      29
    • 2.2.2 Asynchronous Model with Event Handlers

      30
    • 2.2.3 Asynchronous with Windows Callback Model

      31
    • 2.2.4 Asynchronous with Win32 Synchronization Model

      31
    • 2.2.5 Extended Asynchronous Programming Model

      31
• 3. Call State Models

  33
  • 3.1 Call State Model Overview

    33
  • 3.2 Basic Call Model

    33
    • 3.2.1 Basic Call States at the Inbound Interface

      34
    • 3.2.2 Basic Call States at the Outbound Interface

      35
    • 3.2.3 Basic Call States for Call Termination

      35
  • 3.3 Basic Call Model Configuration Options

    36
    • 3.3.1 Call State Configuration

      36
    • 3.3.2 Call State Event Configuration

      37
    • 3.3.3 Call Acknowledgement Configuration

      38
    • 3.3.4 Call Proceeding Configuration

      38
  • 3.4 Basic Call Control in Asynchronous Mode

    39
    • 3.4.1 Inbound Calls in Asynchronous Mode

      39
      • 3.4.1.1 Inbound Calls in Asynchronous Mode Overview

        39
      • 3.4.1.2 Channel Initialization

        42
      • 3.4.1.3 Call Detection

        43
      • 3.4.1.4 Call Offered

        43
      • 3.4.1.5 Call Routing

        44
      • 3.4.1.6 Call Acceptance

        44
      • 3.4.1.7 Call Establishment

        44
      • 3.4.1.8 Overlap Receiving

        44
      • 3.4.1.9 Call Failure

        46
      • 3.4.1.10 Abandoned Calls

        47
      • 3.4.1.11 Inbound Call Scenarios in Asynchronous Mode

        47
    • 3.4.2 Outbound Calls in Asynchronous Mode

      52
      • 3.4.2.1 Outbound Calls in Asynchronous Mode Overview

        53
      • 3.4.2.2 Channel Initialization

        56
      • 3.4.2.3 Call Dialing

        56
      • 3.4.2.4 Call Proceeding

        56
      • 3.4.2.5 Call Alerting

        56
      • 3.4.2.6 Call Connected

        56
      • 3.4.2.7 Overlap Sending

        57
      • 3.4.2.8 Call Failure

        57
      • 3.4.2.9 Outbound Call Scenarios in Asynchronous Mode

        58
    • 3.4.3 Call Termination in Asynchronous Mode

      60
      • 3.4.3.1 Call Termination in Asynchronous Mode Overview

        61
      • 3.4.3.2 User Initiated Termination

        61
      • 3.4.3.3 Network Initiated Termination

        61
      • 3.4.3.4 Call Release

        62
      • 3.4.3.5 Call Termination Call Control Scenarios in Asynchronous Mode

        62
    • 3.4.4 Handling Unsolicited Events

      64
  • 3.5 Advanced Call Control with Call Hold and Transfer

    64
    • 3.5.1 Advanced Call State Model Overview

      64
    • 3.5.2 Advanced Call States for Hold and Transfer

      65
    • 3.5.3 Call Hold

      65
    • 3.5.4 Call Transfer

      66
      • 3.5.4.1 Call Transfer Overview

        66
      • 3.5.4.2 Supervised Transfers

        67
      • 3.5.4.3 Unsupervised Transfers

        69
• 4. Event Handling

  71
  • 4.1 Overview of Event Handling

    71
  • 4.2 Event Categories

    71
  • 4.3 Blocked and Unblocked Event Handling

    72
  • 4.4 Event Retrieval

    73
  • 4.5 Events Indicating Errors

    74
  • 4.6 Masking Events

    74
  • 4.7 Event Handlers

    74
• 5. Application Development Guidelines

  77
  • 5.1 General Programming Tips

    77
  • 5.2 Tips for Programming Drop and Insert Applications

    78
  • 5.3 Using Global Call with Digital Network Interface Boards

    79
    • 5.3.1 Routing Overview

      79
    • 5.3.2 Working with Flexible Routing Configurations

      80
      • 5.3.2.1 Determining Channel Capabilities (Flexible Routing)

        80
      • 5.3.2.2 Using Device Handles (Flexible Routing)

        81
      • 5.3.2.3 Multi-Threading and Multi-Processing (Flexible Routing)

        81
      • 5.3.2.4 Initializing an Application (Flexible Routing)

        81
      • 5.3.2.5 Initializing Global Call (Flexible Routing)

        81
      • 5.3.2.6 Device Initialization Hint (Flexible Routing)

        83
      • 5.3.2.7 Using Protocols (Flexible Routing)

        83
    • 5.3.3 Handling Multiple Call Objects Per Channel in a Glare Condition

      83
• 6. Error Handling

  85
  • 6.1 Error Handling Overview

    85
• 7. Call Control

  87
  • 7.1 Call Progress Analysis when Using IP Technology

    87
  • 7.2 Call Progress Analysis when Using Digital Network Interface Boards

    87
    • 7.2.1 Call Progress Analysis Definition

      87
    • 7.2.2 Configuring Default Call Progress Analysis Parameters

      88
    • 7.2.3 Configuring Call Progress Analysis on a Per Call Basis

      88
    • 7.2.4 Setting Call Analysis Attributes on a Per Call Basis

      90
    • 7.2.5 Configuring Call Progress Analysis on a Per Channel Basis

      91
    • 7.2.6 Setting Call Analysis Attributes on a Per Channel Basis

      92
    • 7.2.7 Customizing Call Progress Tones on a Per Board Basis

      92
  • 7.3 Resource Routing

    93
  • 7.4 Feature Transparency and Extension

    93
    • 7.4.1 Feature Transparency and Extension Overview

      93
    • 7.4.2 Technology-Specific Feature Access

      94
    • 7.4.3 Technology-Specific User Information

      95
• 8. Alarm Handling

  97
  • 8.1 Alarm Handling Overview

    97
    • 8.1.1 Alarm Management System Components

      97
  • 8.2 Operation and Configuration of GCAMS

    99
    • 8.2.1 Generation of Events for Blocking Alarms

      99
    • 8.2.2 Generation of Alarm Events

      100
    • 8.2.3 Configuration of Alarm Properties and Characteristics

      101
      • 8.2.3.1 Configuring Alarm Notification

        102
      • 8.2.3.2 Configuring Alarm Flow

        102
      • 8.2.3.3 Configuring Blocking and Non-Blocking Alarm Classification

        102
      • 8.2.3.4 Configuring Alarm Parameters

        102
      • 8.2.3.5 Alarm Configuration Tips

        103
    • 8.2.4 Starting and Stopping Alarm Transmission

      104
    • 8.2.5 Retrieving Alarm Data

      104
      • 8.2.5.1 Alarm Numbers and Names

        104
      • 8.2.5.2 Alarm Source Object IDs and Names

        104
  • 8.3 Sample Alarm Scenarios

    105
    • 8.3.1 Scenario 1: Application Notified of First and Last Blocking Alarm

      105
    • 8.3.2 Scenario 2: Default Behavior for Alarm Notification

      107
    • 8.3.3 Scenario 3: Alarm Transmission

      108
• 9. Real Time Configuration Management

  109
  • 9.1 Real Time Configuration Manager Overview

    109
  • 9.2 RTCM Components

    110
    • 9.2.1 Customer Application Using Global Call RTCM

      111
    • 9.2.2 Global Call RTCM

      111
    • 9.2.3 RTCM Parameters

      112
  • 9.3 Using RTCM Parameters

    112
    • 9.3.1 Parameter Dependencies

      113
    • 9.3.2 Parameter Definitions

      113
  • 9.4 Getting and Setting Parameter Information

    114
    • 9.4.1 GC_PARM_BLK Data Structure

      114
    • 9.4.2 Control Parameters

      114
      • 9.4.2.1 Programming Mode

        115
      • 9.4.2.2 Timeout Option

        116
      • 9.4.2.3 Update Condition

        116
  • 9.5 Handling RTCM Errors

    117
  • 9.6 Configuration Procedure

    117
  • 9.7 Sample Scenarios Using the RTCM API Functions

    118
    • 9.7.1 Getting or Setting GCLib Configuration in Synchronous Mode

      119
    • 9.7.2 Getting or Setting CCLib Configuration in Synchronous Mode

      120
    • 9.7.3 Getting or Setting Line Device Configuration in Synchronous Mode

      121
    • 9.7.4 Setting Line Device Configuration in Asynchronous Mode

      123
    • 9.7.5 Setting Board Device Configuration in Asynchronous Mode (IP Technology)

      124
• 10. Handling Service Requests

  127
  • 10.1 Service Request Overview

    127
  • 10.2 Service Request Components

    128
  • 10.3 Service Request Data

    129
  • 10.4 General Service Request Scenario

    129
• 11. Using Global Call to Implement Call Transfer

  131
  • 11.1 Introduction to Call Transfer

    131
    • 11.1.1 Blind Call Transfer

      131
    • 11.1.2 Supervised Call Transfer

      132
  • 11.2 Call Transfer State Machine

    132
• 12. Building Applications

  139
  • 12.1 Compiling and Linking

    139
    • 12.1.1 Include Files

      139
    • 12.1.2 Required Libraries

      139
    • 12.1.3 Variables for Compiling and Linking Commands

      140
    • 12.1.4 Dynamically Loaded Libraries

      140
• 13. Debugging

  141
• Glossary

  143
• Index

  151