CAN_Initialize

#ifdef __cplusplus
#define _DEF_ARG =0   // Using of default arguments
#else
#define _DEF_ARG
#endif

TPCANStatus __stdcall CAN_Initialize(
        TPCANHandle Channel,
        TPCANBaudrate Btr0Btr1,
        TPCANType HwType _DEF_ARG,
        DWORD IOPort _DEF_ARG,
        WORD Interrupt _DEF_ARG
);

The return value is a TPCANStatus code. PCAN_ERROR_OK is returned on success. The typical errors in case of failure are:

Note on correspondence of Functions: 

A Channel that is initialized using CAN_Initialize must use CAN_Read and CAN_Write for communication. Calling CAN_ReadFD and/or CAN_WriteFD will result in a PCAN_ERROR_ILLOPERATION error. 

As indicated by its name, the CAN_Initialize function initiates a PCAN Channel, preparing it for communicate within the CAN bus connected to it. Calls to the API functions will fail if they are used with a Channel handle, different than PCAN_NONEBUS, that has not been initialized jet. Each initialized channel should be released when it is not needed anymore. 

Initializing a PCAN Channel means:

• to reserve the Channel for the calling application/process.
• to allocate channel resources, like receive and transmit queues.
• to register/connect the Hardware denoted by the channel handle.
• to check and adapt the bus speed, if the Channel is already in use. (Only if the Channel was pre-configured as Bitrate Adapting; see: Bitrate-Adapting Parameter).
• to set the channel in Listen-Only mode. (Only if the channel was pre-configured as Listen-Only; see: Listen-Only Parameter).
• to open the messages filter for the application/process.
• to set-up the default values of the different parameters (See CAN_GetValue).
• to set the Receive Status of the channel. (Pre-configured value; see: Receive Status Parameter).

Different than the PCAN-Light API, the Initialization process will fail if an application try to initialize a PCAN-Channel that has been initialized already within the same process. 

The PCAN-Basic API use the same function for initializations of both, Plug-And-Play and Not-Plug-And-Play hardware. The CAN_Initialize function has three additional parameters that are only for the connection of Non-Plug-And-Play hardware. With Plug-And-Play hardware, however, only two parameters are to be supplied. The remaining three are not evaluated. 

Take in consideration that initializing a channel causes a reset of the CAN hardware , when the bus status is other than OK. In this way errors like BUSOFF, BUSHEAVY, and BUSLIGHT, are removed. 

PCAN-LAN Channels 

A PCAN-LAN channel doesn't allow changing the bit rate using PCAN-Basic. In order to connect a PCAN-LAN Channel it is necessary to know the bit rate of the PCAN-Gateway device that is represented by that channel. If the bit rate is not known, the parameter Bitrate-Adapting should be used.

The following example shows the initialize and uninitialize processes for a Plug-And-Play channel (channel 2 of a PCAN-PCI hardware) and for a Not-Plug-And-Play channel (channel 1 of the PCAN-DNG). 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. 

C++:  

TPCANStatus result;
char strMsg[256];

// The Plug & Play Channel (PCAN-PCI) is initialized
//
result = CAN_Initialize(PCAN_PCIBUS2,PCAN_BAUD_500K);
if(result != PCAN_ERROR_OK)
{
    // An error occurred, get a text describing the error and show it
    //
    CAN_GetErrorText(result, 0, strMsg);
    MessageBox(strMsg);
}
else
    MessageBox("PCAN-PCI (Ch-2) was initialized");

// The Not Plug & Play Channel (PCAN-Dongle) is initialized
//
result = CAN_Initialize(PCAN_DNGBUS1, PCAN_BAUD_500K, PCAN_TYPE_DNG, 0x378, 7);
if(result != PCAN_ERROR_OK)
{
    // An error occurred, get a text describing the error and show it
    //
    CAN_GetErrorText(result, 0, strMsg);
    MessageBox(strMsg);
}
else
    MessageBox("PCAN-Dongle (Ch-1) was initialized");

....

// All initialized channels are released
//
CAN_Uninitialize(PCAN_NONEBUS);

CAN_Uninitialize 

CAN_GetValue 

Understanding PCAN-Basic 

Class-method Version: Initialize