 |
ProbeAttenuation
| Public Data Item |
Declared in: NiIviScope.h |
Declaration
double ProbeAttenuation[];
Description
Specifies the scaling factor by which the probe you attach to the channel attenuates the input. For example, when you use a 10:1 probe, set this property to 10.0.
This driver reserves negative values to control the oscilloscope's automatic probe sense capability. Setting this property to CNiIviScope::OnProbeSense configures the oscilloscope to sense the attenuation of the probe automatically. After you enable the automatic probe sense, subsequent queries of this property return the value CNiIviScope::OnProbeSense. Use the ProbeSense property to obtain the actual probe attenuation.
If you set the oscilloscope to sense the probe attenuation automatically, the probe attenuation value can change at any time. When the oscilloscope detects a new probe attenuation value, other settings in the oscilloscope might also change. The driver has no way of knowing when these changes occur. Therefore, when you enable the automatic probe sense capability, this driver disables caching for properties that depend on the probe attenuation. These properties include Range, Offset and all the properties that configure trigger levels. To maximize performance, set this property to a manual probe attenuation setting.
If the oscilloscope is set to sense the probe attenuation automatically, setting this property to a positive value disables the automatic probe sense and configures the oscilloscope to use the manual probe attenuation you specify.
If you use a manual probe attenuation, you must set this property to reflect the new probe attenuation each time you attach a different probe.
