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 CALMATRIX functions to program the Matrix.
CalMatrixInitialize (sAddress, phHandle, plStatus)
Name |
Type |
Comments |
sAddress |
STR |
Address of Matrix. |
phHandle |
PLONG |
Returned handle for Matrix 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 two Matrices at PXI addresses 0x105 and 6.
LONG lHandle1, lHandle2, lStatus;
CalMatrixInitialize (“PXI:0x105”, &lHandle1 &lStatus);
CalMatrixInitialize (“PXI:6”, &lHandle2, &lStatus);