niDCPower_CreateAdvancedSequenceWithChannels
- Updated2023-04-15
- 2 minute(s) read
ViStatus niDCPower_CreateAdvancedSequenceWithChannels(ViSession vi, ViConstString sequenceName, ViInt32 attributeIDCount,ViInt32 attributeIDs[], viBoolean setAsActiveSequence);
Purpose
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.
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.
 |
Note 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.
|
Note 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:
niDCPower_CreateAdvancedSequenceStep
Parameters
| Input | ||
| Name | Type | Description |
| vi | ViSession | Identifies a particular instrument session. vi is obtained from the niDCPower_InitializeWithIndependentChannels function. |
| channelName | 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 | ViConstString | Specifies the name of the sequence to create. |
| attributeIDCount | ViInt32 | Specifies the number of attributes in the attributeIDs array. |
| attributeIDs | ViInt32[] |
Specifies the attributes you reconfigure per step in the advanced sequence. Refer to Supported Properties by Device for more information on properties that can be configured in an advanced sequence and their respective supported device.
|
| setAsActiveSequence | ViBoolean | Specifies that this current sequence is active. |
Return Value
| Name | Type | Description |
| Status | ViStatus | Reports the status of this operation. To obtain a text description of the status code, call the niDCPower_error_message function. To obtain additional information concerning the error condition, call the niDCPower_GetError function. |