DeviceSpecificFeature Method (inputData, feature, outputDataSize)

Provides access to device specific features.

Declaration Syntax

Visual Basic

Visual C++

public byte[] DeviceSpecificFeature(
	byte[] inputData,
	uint feature,
	int outputDataSize
)

Public Function DeviceSpecificFeature ( _
	inputData As Byte(), _
	feature As UInteger, _
	outputDataSize As Integer _
) As Byte()

public:
array<unsigned char>^ DeviceSpecificFeature(
	array<unsigned char>^ inputData, 
	unsigned int feature, 
	int outputDataSize
)

Parameters

inputData (array< Byte >[]()[]): A byte array that contains input data.

feature (UInt32): The parameter value uniquely identifies the feature to invoke on the device.

outputDataSize (Int32): Size of output data, in bytes. Set to zero if specific function does not return any data.

Return Value

A byte array with output data or null reference (Nothing in Visual Basic) if there is no output data.

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 your 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:
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.

Exceptions

Exception	Condition
TapiException	DeviceSpecificFeature failed because of Telephony API (TAPI) error.