niDCPower_CreateAdvancedSequenceWithChannels
- Updated2025-10-06
- 2 minute(s) read
Creates an empty advanced sequence. Call the niDCPower_CreateAdvancedSequenceStepWithChannels function to add steps to the active advanced sequence or, optionally, the niDCPower_CreateAdvancedSequenceCommitStepWithChannels function to add a Commit step to the active advanced sequence.
Syntax
ViStatus _VI_FUNC niDCPower_CreateAdvancedSequenceWithChannels(ViSession vi, ViConstString channelName, ViConstString sequenceName, ViInt32 attributeIdCount, const ViInt32 attributeIds[], ViBoolean setAsActiveSequence)
Remarks
You can create multiple advanced sequences for a channel. Advanced sequences for a particular channel are independent from any advanced sequences of other channels. You can configure advanced sequences for one channel at a time or you can confiugre identical advanced sequences for multiple channels in unison.
Each channel can have only one active advanced sequence at a time.
Support for this function
You must set the source mode to Sequence to use this function.
This function is not supported on all devices. Refer to Supported Functions by Device for more information about supported devices.
Using the niDCPower_SetSequence function with Advanced Sequence functions for the same channel in the same session is unsupported.
Use this function in the Uncommitted or Committed programming states.
Related Topics:
Parameters
| Name | Direction | Type | Description |
|---|---|---|---|
| vi | [in] | ViSession | Identifies a particular instrument session. vi is obtained from the niDCPower_InitializeWithIndependentChannels function. |
| channelName | [in] | ViConstString | Specifies the channel(s) to use. Specify the channel(s) using the form PXI1Slot3/0,PXI1Slot3/2-3,PXI1Slot4/2-3 or PXI1Slot3/0,PXI1Slot3/2:3,PXI1Slot4/2:3, where PXI1Slot3 and PXI1Slot4 are instrument resource names and 0, 2, and 3 are channels. If you pass "" for this control, all channels in the session are used. |
| sequenceName | [in] | ViConstString | Specifies the name of the sequence to create. |
| attributeIdCount | [in] | ViInt32 | Specifies the number of attributes in the attributeIds array. |
| attributeIds | [in] | const ViInt32[] | Specifies the attributes you reconfigure per step in the advanced sequence. Refer to Supported Attributes by Device for more information on attributes that can be configured in an advanced sequence and their respective supported device. |
| setAsActiveSequence | [in] | ViBoolean | Specifies that this current sequence is active. |
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 |