niDCPower_self_test
- Updated2025-10-06
- 1 minute(s) read
Performs the device self-test routine and returns the test result(s). Calling this function implicitly calls the niDCPower_ResetWithChannels function.
Syntax
ViStatus _VI_FUNC niDCPower_self_test(ViSession vi, ViInt16 *selfTestResult, ViChar selfTestMessage[IVI_MAX_MESSAGE_BUF_SIZE])
Remarks
When calling this function with the PXIe-4162/4163, specify all channels of your PXIe-4162/4163 with the resourceName input of the niDCPower_InitializeWithIndependentChannels function. You cannot self test a subset of PXIe-4162/4163 channels.
Parameters
| Name | Direction | Type | Description | ||||||
|---|---|---|---|---|---|---|---|---|---|
| vi | [in] | ViSession | Identifies a particular instrument session. vi is obtained from the niDCPower_InitializeWithIndependentChannels function. | ||||||
| selfTestResult | [out] | ViInt16 * | Returns the value result from the device self-test.
| ||||||
| selfTestMessage | [out] | ViChar[IVI_MAX_MESSAGE_BUF_SIZE] | Returns the self-test result message. The size of this array must be at least 256 bytes. |
Returns
Reports the status of this operation. To obtain a text description of the status code, call niDCPower_error_message. To obtain additional information concerning the error condition, call niDCPower_GetError. The general meaning of the status code is as follows:
Value | Meaning |
|---|---|
0 | Success |
Positive Values | Warnings |
Negative Values | Errors |