ChannelVersion

This parameter is used to retrieve information about the underlying device driver, as well as to obtain copyright information. It can be used as informational output about the installed device driver in an application.

Availability

It is available since PCAN-Basic version 1.0.0.

Supported By

PCAN-USB: Channels Usb01 to Usb16.
PCAN-PCI: Channels Pci01 to Pci16
PCAN-LAN: Channels Lan01 to Lan16.

Access Mode

This parameter can only be read. It cannot be modified.

Possible Values

The information about driver version and copyright is represented as a multi-line string (4 lines), offering the following information in each line:

Line 1: Device driver name and driver version.
Line 2: Architecture implemented on the driver and targeted platform.
Line 3: Year of copyright.
Line 4: Company name and city where its head office is located.

Note

This format is available beginning with the device driver version 3.x. The returned value is a null terminated string with a maximum length of 256 bytes (null-termination included).

Default Value

Does not apply.

Initialization Status

Get: This parameter can be used on both, initialized and uninitialized PCAN Channels.

Example

The following code shows how to retrieve version information related to a USB Channel:

C#

string channelVersion;
PcanChannel channelUsed = PcanChannel.Usb01;

if (Api.GetValue(channelUsed, PcanParameter.ChannelVersion, out channelVersion) == PcanStatus.OK)
{
    Console.WriteLine($"{channelUsed} associated information:");
    Console.WriteLine(channelVersion);
}
else
    Console.WriteLine($"It was not possible to get information about the channel {channelUsed}");

VB

Dim channelVersion As String = Nothing
Dim channelUsed As PcanChannel = PcanChannel.Usb01

If Api.GetValue(channelUsed, PcanParameter.ChannelVersion, channelVersion) = PcanStatus.OK Then
    Console.WriteLine($"{channelUsed} associated information:")
    Console.WriteLine(channelVersion)
Else
    Console.WriteLine($"It was not possible to get information about the channel {channelUsed}")
End If

C++

String^ channelVersion;
PcanChannel channelUsed = PcanChannel::Usb01;

if (Api::GetValue(channelUsed, PcanParameter::ChannelVersion, channelVersion) == PcanStatus::OK)
{
    Console::WriteLine("{0} associated information:", channelUsed);
    Console::WriteLine(channelVersion);
}
else
    Console::WriteLine("It was not possible to get information about the channel {0}", channelUsed);