CalCounterInitialize

Purpose

Initializes the driver for the board at the specified address of VISA resource. The function returns a handle that can be used with other CalCounterXXXX functions to program the counter.

Syntax

CalCounterInitialize (sAddress, phHandle, plStatus)

Parameters

Name
Type
Comments
sAddress
STR
Address of Counter.
pnHandle
PLONG
Returned handle for Counter access.
plStatus
PLONG
Returned status: 0 on success, negative number on failure.

Comments

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 Driver topic 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.

Example

The following example initializes two counters at address 2 and 0x103.

 

LONG   lHandle1, lHandle2, lStatus;

 

CalCounterInitialize (“PXI:2”, &lHandle1, &lStatus);

CalCounterInitialize (“PXI:0x103”, &lHandle2, &lStatus);

 

See Also

CalCounterReset, CalCounterGetError