Important
For more information about each available TPCANParameter, please refer to the companion PDF documentation PCAN-Parameter_Documentation.pdf.
public static TPCANStatus GetValue(
ushort Channel,
TPCANParameter Parameter,
out ulong NumericBuffer,
uint BufferLength
)
Public Shared Function GetValue (
Channel As UShort,
Parameter As TPCANParameter,
<OutAttribute> ByRef NumericBuffer As ULong,
BufferLength As UInteger
) As TPCANStatus
public:
static TPCANStatus GetValue(
unsigned short Channel,
TPCANParameter Parameter,
[OutAttribute] unsigned long long% NumericBuffer,
unsigned int BufferLength
)
The return value is a TPCANStatus value. PCAN_ERROR_OK is returned on success. The typical errors in case of failure are:
Use the method GetValue to get information about PCAN environment as parameters like the Acceptance Filter (Code/Mask). Take in account that not all parameters are supported for all PCAN Channels. The access's type of the parameters can also be different.
For more information about the possible values that can be retrieved, see Parameter Value Definitions
The following example shows the use of GetValue(UInt16, TPCANParameter, UInt64, UInt32) method on the channel PCAN_USBBUS1 to retrieve the configured message filter as 11-bit acceptance code and mask. In case of failure, the returned code will be translated to a text (according with the operating system language) in English, German, Italian, French or Spanish, and it will be shown to the user.
TPCANStatus result;
System.Text.StringBuilder strMsg;
UInt64 i64Buffer;
UInt32 iCode, iMask;
strMsg = new System.Text.StringBuilder(256);
// ... channel is initialized ...
// The 11-bit acceptance filter of the PCAN-USB Channel 1 is asked
//
result = PCANBasic.GetValue(PCANBasic.PCAN_USBBUS1, TPCANParameter.PCAN_ACCEPTANCE_FILTER_11BIT, out i64Buffer, sizeof(UInt64));
if (result != TPCANStatus.PCAN_ERROR_OK)
{
// An error occurred, get a text describing the error and show it
//
PCANBasic.GetErrorText(result, 0, strMsg);
Console.WriteLine(strMsg.ToString());
}
else
{
// Code and mask are extracted from the 64-bit numeric value
//
iCode = Convert.ToUInt32(i64Buffer >> 32);
iMask = Convert.ToUInt32(i64Buffer & UInt32.MaxValue);
// A text is shown giving information about the 11-bit mask and code of the acceptance filter
//
Console.WriteLine(string.Format("Configured 11-bit acceptance filter: Code: {0:X8} | Mask: {1:X8}", iCode, iMask));
}
Dim result As TPCANStatus
Dim strMsg As System.Text.StringBuilder
Dim i64Buffer As UInt64
Dim iCode As UInt32
Dim iMask As UInt32
strMsg = New System.Text.StringBuilder(256)
' ... channel is initialized ...
' The 11-bit acceptance filter of the PCAN-USB Channel 1 is asked
'
result = PCANBasic.GetValue(PCANBasic.PCAN_USBBUS1, TPCANParameter.PCAN_ACCEPTANCE_FILTER_11BIT, i64Buffer, CType(System.Runtime.InteropServices.Marshal.SizeOf(i64Buffer), UInteger))
If result <> TPCANStatus.PCAN_ERROR_OK Then
' An error occurred, get a text describing the error and show it
'
PCANBasic.GetErrorText(result, 0, strMsg)
Console.WriteLine(strMsg.ToString())
Else
' Code and mask are extracted from the 64-bit numeric value
'
iCode = Convert.ToUInt32(i64Buffer >> 32)
iMask = Convert.ToUInt32(i64Buffer And UInt32.MaxValue)
' A text is shown giving information about the 11-bit mask and code of the acceptance filter
'
Console.WriteLine(String.Format("Configured 11-bit acceptance filter: Code: {0:X8} | Mask: {1:X8}", iCode, iMask))
End If
TPCANStatus result;
System::Text::StringBuilder^ strMsg;
UInt64 i64Buffer;
UInt32 iCode, iMask;
strMsg = gcnew System::Text::StringBuilder(256);
// ... channel is initialized ...
// The 11-bit acceptance filter of the PCAN-USB Channel 1 is asked
//
result = PCANBasic::GetValue(PCANBasic::PCAN_USBBUS1, TPCANParameter::PCAN_ACCEPTANCE_FILTER_11BIT, i64Buffer, sizeof(i64Buffer));
if (result != TPCANStatus::PCAN_ERROR_OK)
{
// An error occurred, get a text describing the error and show it
//
PCANBasic::GetErrorText(result, 0, strMsg);
Console::WriteLine(strMsg->ToString());
}
else
{
// Code and mask are extracted from the 64-bit numeric value
//
iCode = Convert::ToUInt32(i64Buffer >> 32);
iMask = Convert::ToUInt32(i64Buffer & UInt32::MaxValue);
// A text is shown giving information about the 11-bit mask and code of the acceptance filter
//
Console::WriteLine(String::Format("Configured 11-bit acceptance filter: Code: {0:X8} | Mask: {1:X8}", iCode, iMask));
}