Initializes the driver for the board at the specified slot number. The function returns a handle that can be used with other GX3722 function.
Gx3722Initialize (nSlot, pnHandle, pnStatus)
Name |
Type |
Comments |
nSlot |
SHORT |
GX3722 board slot number on the PXI bus. |
pnHandle |
PSHORT |
Returned handle for the board. The handle is set to zero on error and <> 0 on success. |
pnStatus |
PSHORT |
Returned status: 0 on success, negative number on failure. |
The Gx3722Initialize() API function verifies whether or not the GX3722 board exists in the specified PXI slot. The function does not change any of the board settings. The function uses the HW driver to access and program the board.
The Marvin Test Solutions HW device driver is installed with the driver and is the default device driver. The function returns a handle that for use with other Counter functions to program the board. The function does not change any of the board settings.
The specified PXI slot number is displayed by the PXI/PCI Explorer applet that can be opened from the Windows Control Panel. You may also use the label on the chassis below the PXI slot where the board is installed. The function accepts two types of slot numbers:
A combination of chassis number (chassis # x 256) with the chassis slot number. For example, 0x105 (chassis 1 slot 5).
Legacy nSlot as used by earlier versions of HW/VISA. The slot number contains no chassis number and can be changed using the PXI/PCI Explorer applet (1-255).
The returned handle pnHandle is used to identify the specified board with other GX3722 functions.
The following example initializes two GX3722 boards at slots 2 and 4.
SHORT nHandle1, nHandle2, nStatus;
Gx3722Initialize (2, &nHandle1, &nStatus);
Gx3722Initialize (4, &nHandle2, &nStatus);
if (nHandle1==0 || nHandle2==0)
{
printf(“Unable to Initialize the board”)
return;
}