Click or drag to resize
TapiLineDeviceSpecific Method (Byte, TapiAddress, TapiCall, Int32)
Provides access to device specific functionality.

Namespace: Traysoft.AddTapi
Assembly: Traysoft.AddTapi (in Traysoft.AddTapi.dll) Version: 6.0.0.1110
Syntax
public byte[] DeviceSpecific(
	byte[] inputData,
	TapiAddress address,
	TapiCall call,
	int outputDataSize
)

Parameters

inputData
Type: SystemByte
A byte array that contains input data.
address
Type: Traysoft.AddTapiTapiAddress
An address on the line (if required for the specific function). Set to null reference (Nothing in Visual Basic) if not required.
call
Type: Traysoft.AddTapiTapiCall
A call on the line (if required for the specific function). Set to null reference (Nothing in Visual Basic) if not required.
outputDataSize
Type: SystemInt32
Size of output data, in bytes. Set to zero if specific function does not return any data.

Return Value

Type: Byte
A byte array with output data or null reference (Nothing in Visual Basic) if there is no output data.
Exceptions
ExceptionCondition
TapiExceptionDeviceSpecific failed because of Telephony API (TAPI) error.
Remarks

Many TSPs provide functionality specific to the telephony system using device specific extensions. DeviceSpecific method allows the application to access device specific functions implemented by the TSP. Please refer to the TAPI documentation for the telephony hardware to find out about device specific functionality supported by the telephony service provider.

The application has to negotiate a version of the extension supported by the line device using NegotiateDeviceSpecificExtensionVersion(UInt32, UInt32) before opening the line in order to use DeviceSpecific method.

Note Note
This method should be used when input or output data have variable length. Make sure to specify outputDataLength large enough to hold all output data. Use DeviceSpecific(Object, TapiAddress, TapiCall, Type) when device specific function has fixed size structures as input and output data. Please feel free to contact us and we will gladly help with more complex scenarios.
See Also