pipx40_setDriverMode
|
Function |
pipx40_setDriverMode (ByVal newMode As Long, ByRef previousMode As Long) As Long | |
|
ViStatus |
pipx40_setDriverMode (ViUInt32 newMode, ViPUInt32 previousMode); |
|
Parameter |
I/O |
Description |
|
newMode |
in |
New value for driver mode flags |
|
previousMode |
out |
The driver's mode flags prior to executing this function. |
Return Value
0 = Successful operation. Negative values are error codes and positive values are warnings. To get a description of the error, pass the error code to pipx40_error_message.
Description
Allows control flags affecting the driver's global behaviour to be set and read. This function gives access to low-level control features of the pipx40 driver and is intended for 'expert' use only - the default driver behaviour should be satisfactory for the great majority of applications.
Remarks
Individual bits in the mode value control various aspects of driver operation.
Setting the value zero (pipx40_MODE_DEFAULT) clears all special driver modes.
Control bit values may be summed to enable multiple driver features.
|
Driver constant |
Bit value - hexadecimal |
Description |
|
pipx40_MODE_NO_WAIT |
00000001 |
Function calls return without waiting for card operations to complete |
|
pipx40_MODE_UNLIMITED |
00000002 |
Disable maximium closure limits - see Warning below |
|
pipx40_MODE_IGNORE_TEST |
00000008 |
Enable card operation even if selftest fails - see Warning below |
Warning - pipx40_MODE_UNLIMITED
Use of pipx40_MODE_UNLIMITED to disable the maximum number of crosspoint closures permitted on high-density cards is not recommended, because it carries the danger of overheating and consequent damage to both the card itself and the system in which it is installed. See Closure Limits.
Warning - pipx40_MODE_IGNORE_TEST
The pipx40_MODE_IGNORE_TEST feature should be used with extreme caution. If a defective card is forcibly enabled, under some fault conditions a large number of outputs could be energised spuriously, resulting in overheating and consequent damage to both the card itself and the system in which it is installed. The intended purpose of this feature is to allow continued operation of a BRIC unit from which a daughtercard has been removed for maintenance. See BRIC Operation.