pipx40_setDriverMode

ViStatus pipx40_setDriverMode (ViUInt32 newMode, ViPUInt32 previousMode);

Purpose

Sets and reads flags controlling driver options.

Parameters

Input
Name Type Description
newMode ViUInt32

A bit-pattern representing the desired driver mode settings.
Bit Significance:
0x00000000 = pipx40_MODE_DEFAULT
Default, no special modes set
0x00000001 = pipx40_MODE_NO_WAIT
Function calls do not wait for operations to
complete before returning
0x00000002 = pipx40_MODE_UNLIMITED
Disable closure limits - see WARNING
0x00000008 = pipx40_MODE_IGNORE_TEST
Allow card operation despite selftest fault -
see WARNING
WARNING: Use of pipx40_MODE_UNLIMITED to disable the maximum number of crosspoint closures permitted on high-density matrix 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.
WARNING: pipx40_MODE_IGNORE_TEST should be used with extreme caution. Under some circumstances enforced operation of a faulty card could lead to overheating and consequent damage to both the card itself and the system in which it is installed.

Output
Name Type Description
previousMode ViUInt32 (passed by reference)

A bit-pattern representing the driver mode settings prior to executing this function.
Bit Significance:
0x00000000 = pipx40_MODE_DEFAULT
Default, no special modes set
0x00000001 = pipx40_MODE_NO_WAIT
Function calls do not wait for operations to
complete before returning
0x00000002 = pipx40_MODE_UNLIMITED
Disable closure limits
0x00000008 = pipx40_MODE_IGNORE_TEST
Allow card operation despite selftest fault

Return Value

Name Type Description
status ViStatus

A numeric code indicating the success or failure of the operation.
VI_SUCCESS = Successful operation.
Negative values are error codes and positive values are warnings.
To get a description of an error, pass the error code to pipx40_error_message.

References

Mode Control
Pickering Interfaces PXI VISA
Alphabetical Function Index
Hierarchical Function Index