ni4133_ContactCheck
- Updated2025-11-18
- 2 minute(s) read
Performs positive contact detection to the DUT according to the given output current level and voltage limit.
Syntax
ni4133_Status NI4133_DECL ni4133_ContactCheck(ni4133_SessionHandle sessionHandle, double outputCurrentLevel, double outputVoltageLimit, double measurementDelay, double measurementTime, ni4133_MeasurementMode measurementMode, double *deltaTime, double currentMeasurementBuffer[], double voltageMeasurementBuffer[], size_t bufferSize, size_t *actualBufferSize)
Parameters
| Name | Direction | Type | Description | |||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| sessionHandle | [in] | ni4133_SessionHandle | Specifies the session to perform contact check. | |||||||||
| outputCurrentLevel | [in] | double | Specifies the current level to source for detection. | |||||||||
| outputVoltageLimit | [in] | double | Specifies the clamping voltage of the PXIe-4133 during contact detection. | |||||||||
| measurementDelay | [in] | double | Specifies the delay, in seconds, between sourcing current and measuring voltage and current. | |||||||||
| measurementTime | [in] | double | Specifies the time, in seconds, over which the contact detection measurement is taken. Increase this time to improve measurement resolution. | |||||||||
| measurementMode | [in] | ni4133_MeasurementMode | Specifies how the measurement would be taken. Defined Values:
| |||||||||
| deltaTime | [out] | double * | Returns the sampling period of the measurements. | |||||||||
| currentMeasurementBuffer | [out] | double[] | An array that contains the requested number of current measurements. | |||||||||
| voltageMeasurementBuffer | [out] | double[] | An array that contains the requested number of voltage measurements. | |||||||||
| bufferSize | [in] | size_t | Specifies the buffer size for voltage measurements. Set this field to 0 to query the expected buffer size for a given set of parameters. The actual required buffer size is returned by actualBufferSize. | |||||||||
| actualBufferSize | [out] | size_t * | Returns the actual buffer size for all valid measurements. The buffer must be allocated at least to the size value specified. |
Returns
Reports the status of this operation.
To obtain a text description of the status code, call ni4133_GetErrorDescription. The general meaning of the status code is as follows:
Value | Meaning |
|---|---|
Positive Values | Warnings |
Negative Values | Errors |