DeviceSpecificFeature Event

Notifies the application about device specific events occurring on a line, address, or call.

Declaration Syntax

Visual Basic

Visual C++

public static event TapiDeviceSpecificEventHandler DeviceSpecificFeature

Public Shared Event DeviceSpecificFeature As TapiDeviceSpecificEventHandler

public:
static  event TapiDeviceSpecificEventHandler^ DeviceSpecificFeature {
	void add (TapiDeviceSpecificEventHandler^ value);
	void remove (TapiDeviceSpecificEventHandler^ value);
}

Remarks

DeviceSpecificFeature event is used by a telephony service provider to notify the application about device specific events. The application must negotiate device specific extension version using NegotiateDeviceSpecificExtensionVersion(UInt32, UInt32) before opening the line to receive DeviceSpecificFeature events. The meaning of the event and its parameters are device specific. Please refer to the TAPI documentation for your telephony hardware to find out about device specific functionality supported by the telephony service provider.

Note:
In Windows Forms application AddTapi.NET executes the handler of this event on the main thread of the application (the thread that called Initialize(String)). It is safe to access Windows Forms controls from the event handler without using Invoke mechanism.

Examples

The following code shows how to process DeviceSpecific event.

            TapiApp.Initialize("MyApp");
            TapiApp.DeviceSpecificFeature += OnDeviceSpecificFeature;
            ...
            
            void OnDeviceSpecificFeature(object sender, TapiDeviceSpecificEventArgs args)
            {
                Console.WriteLine("Device specific feature event on line {0}", args.Line.Name);
                Console.WriteLine("Param1={0}, Param2={1}, Param3={2}", args.Param1, args.Param2, args.Param3);
            }

VB.NET

            TapiApp.Initialize("MyApp")
            AddHandler TapiApp.DeviceSpecificFeature, AddressOf OnDeviceSpecificFeature
            ...
            
            Private Sub OnDeviceSpecificFeature(ByVal sender As Object, ByVal args As TapiDeviceSpecificEventArgs)
                Console.WriteLine("Device specific feature event on line {0}", args.Line.Name)
                Console.WriteLine("Param1={0}, Param2={1}, Param3={2}", args.Param1, args.Param2, args.Param3)
            End Sub