Initializes the driver for the board at the specified slot number. The function returns a handle that can be used with other GX3748 function.
Gx3748Initialize (nSlot, pnHandle, pnStatus)
Name |
Type |
Comments |
nSlot |
SHORT |
GX3748 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 Gx3748Initialize function verifies whether or not the GX3748 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 248) 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 GX3748 functions.
The following example initializes two GX3748 boards at slot 1 and 2.
SHORT nHandle1, nHandle2, nStatus;
Gx3748Initialize (1, &nHandle1, &nStatus);
Gx3748Initialize (2, &nHandle2, &nStatus);
if (nHandle1==0 || nHandle2==0)
{
printf(“Unable to Initialize the board”)
return;
}