Initializes the driver for the board at the specified address, which includes support for VISA resource. The function returns a handle that can be used with other CALFGEN functions to program the Function Generator.
CalFgenInitialize (sAddress, phHandle, plStatus)
Name |
Type |
Comments |
sAddress |
STR |
Address of a Function Generator. |
phHandle |
PLONG |
Returned handle for Function Generator access. |
plStatus |
PLONG |
Returned status: 0 on success, negative number on failure. |
The function verifies and establishes communication with the instrument at the specified address information. The address information can be PXI, GPIB, USB, WinSock or VISA resource string. This address string format is starting by the address type followed by a column and the address: PXI | GPIB | WinSock | USB | Com | VISA : Address . The specifics of the Address string characteristics can be found in Writing a Standard Drivertopic in step 5. The function does not change any of the board settings.
The returned handle phHandle is used to identify the specified instrument with other driver functions.
The following example initializes a Function Generator at GPIB address 15:
LONG lHandle, lStatus;
CalFgenInitialize (“GPIB:1:15”, &lHandle &lStatus);