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