Click or drag to resize
TapiLineDeviceSpecificFeature Method (Byte, UInt32, Int32)
Provides access to device specific features.

Namespace: Traysoft.AddTapi
Assembly: Traysoft.AddTapi (in Traysoft.AddTapi.dll) Version: 6.0.0.1110
Syntax
public byte[] DeviceSpecificFeature(
	byte[] inputData,
	uint feature,
	int outputDataSize
)

Parameters

inputData
Type: SystemByte
A byte array that contains input data.
feature
Type: SystemUInt32
The parameter value uniquely identifies the feature to invoke on the device.
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
TapiExceptionDeviceSpecificFeature failed because of Telephony API (TAPI) error.
Remarks

Many TSPs provide functionality specific to the telephony system using device specific extensions. DeviceSpecificFeature method allows the application to access device specific features 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 DeviceSpecificFeature 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 DeviceSpecificFeature(Object, UInt32, 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