NI DCPOWER Trigger And Event Functions - ni/grpc-device GitHub Wiki

Trigger And Event Functions

niDCPower_ConfigureDigitalEdgeStartTriggerWithChannels

ViStatus niDCPower_ConfigureDigitalEdgeStartTriggerWithChannels(ViSession vi, ViConstString inputTerminal, ViInt32 edge);

Purpose

Configures the Start trigger for digital edge triggering.

Note  This function is not supported on all devices. Refer to Supported Functions by Device for more information about supported devices.

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.

inputTerminal ViConstString

Specifies the input terminal for the digital edge Start trigger.

You can specify any valid input terminal for this function. Valid terminals are listed in MAX under the Device Routes tab. For the PXIe-4147 and PXIe-4162/4163, refer to the Signal Routing topic for the device to determine which routes are available. This information is not available on a Device Routes tab in MAX.

Specify the input terminal using the form /Dev1/PXI_Trig0, where Dev1 is the instrument and PXI_Trig0 is the terminal. The input terminal can also be a terminal from another instrument or channel. For example, you can set the input terminal on Dev1 to be /Dev2/Engine0/SourceCompleteEvent, where Engine0 is channel 0.

edge ViInt32 Specifies whether to configure the Start trigger to assert on the rising or falling edge.

Defined Values:
NIDCPOWER_VAL_RISING (1016) Asserts the trigger on the rising edge of the digital signal.
NIDCPOWER_VAL_FALLING (1017) Asserts the trigger on the falling edge of the digital signal.

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.

niDCPower_ConfigureDigitalEdgeStartTrigger

ViStatus niDCPower_ConfigureDigitalEdgeStartTrigger(ViSession vi, ViConstString inputTerminal, ViInt32 edge);

Purpose

This function is deprecated. Use niDCPower_ConfigureDigitalEdgeStartTriggerWithChannels instead.

Configures the Start trigger for digital edge triggering.

Note  This function is not supported on all devices. Refer to Supported Functions by Device for more information about supported devices.

Parameters

Input
Name Type Description
vi ViSession Identifies a particular instrument session. vi is obtained from the niDCPower_InitializeWithIndependentChannels function.
inputTerminal ViConstString

Specifies the input terminal for the digital edge Start trigger.

You can specify any valid input terminal for this function. Valid terminals are listed in MAX under the Device Routes tab. For the PXIe-4147 and PXIe-4162/4163, refer to the Signal Routing topic for the device to determine which routes are available. This information is not available on a Device Routes tab in MAX.

Input terminals can be specified in one of two ways. If the device is named Dev1 and your terminal is PXI_Trig0, you can specify the terminal with the fully qualified terminal name, /Dev1/PXI_Trig0, or with the shortened terminal name, PXI_Trig0. The input terminal can also be a terminal from another device. For example, you can set the input terminal on Dev1 to be /Dev2/SourceCompleteEvent.

edge ViInt32 Specifies whether to configure the Start trigger to assert on the rising or falling edge.

Defined Values:
NIDCPOWER_VAL_RISING (1016) Asserts the trigger on the rising edge of the digital signal.
NIDCPOWER_VAL_FALLING (1017) Asserts the trigger on the falling edge of the digital signal.

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.

niDCPower_ConfigureSoftwareEdgeStartTriggerWithChannels

ViStatus niDCPower_ConfigureSoftwareEdgeStartTriggerWithChannels(ViSession vi);

Purpose

Configures the Start trigger for software edge triggering. Use the niDCPower_SendSoftwareEdgeTriggerWithChannels function to assert the trigger condition.

Note  This function is not supported on all devices. Refer to Supported Functions by Device for more information about supported devices.

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.

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.

niDCPower_ConfigureSoftwareEdgeStartTrigger

ViStatus niDCPower_ConfigureSoftwareEdgeStartTrigger(ViSession vi);

Purpose

This function is deprecated. Use niDCPower_ConfigureSoftwareEdgeStartTriggerWithChannels instead.

Configures the Start trigger for software triggering. Use the niDCPower_SendSoftwareEdgeTrigger function to assert the trigger condition.

Note  This function is not supported on all devices. Refer to Supported Functions by Device for more information about supported devices.

Parameters

Input
Name Type Description
vi ViSession Identifies a particular instrument session. vi is obtained from the niDCPower_InitializeWithIndependentChannels function.

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.

niDCPower_DisableStartTriggerWithChannels

ViStatus niDCPower_DisableStartTriggerWithChannels(ViSession vi);

Purpose

Disables the Start trigger. The specified channel(s) do not wait for a Start trigger when starting generation or acquisition.

This function is necessary only if you configured a Start trigger in the past and now want to disable it.

Note  This function is not supported on all devices. Refer to Supported Functions by Device for more information about supported devices.

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.

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.

niDCPower_DisableStartTrigger

ViStatus niDCPower_DisableStartTrigger(ViSession vi);

Purpose

This function is deprecated. Use niDCPower_DisableStartTriggerWithChannels instead.

Disables the Start trigger. The device does not wait for a Start trigger when starting generation or acquisition.

Note  This function is not supported on all devices. Refer to Supported Functions by Device for more information about supported devices.

Parameters

Input
Name Type Description
vi ViSession Identifies a particular instrument session. vi is obtained from the niDCPower_InitializeWithIndependentChannels function.

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.

niDCPower_ConfigureDigitalEdgeSourceTriggerWithChannels

ViStatus niDCPower_ConfigureDigitalEdgeSourceTriggerWithChannels(ViSession vi, ViConstString inputTerminal, ViInt32 edge);

Purpose

Configures the Source trigger for digital edge triggering.

Note  This function is not supported on all devices. Refer to Supported Functions by Device for more information about supported devices.

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.

inputTerminal ViConstString

Specifies the input terminal for the digital edge Source trigger.

You can specify any valid input terminal for this function. Valid terminals are listed in MAX under the Device Routes tab. For the PXIe-4147 and PXIe-4162/4163, refer to the Signal Routing topic for the device to determine which routes are available. This information is not available on a Device Routes tab in MAX.

Specify the input terminal using the form /Dev1/PXI_Trig0, where Dev1 is the instrument and PXI_Trig0 is the terminal. The input terminal can also be a terminal from another instrument or channel. For example, you can set the input terminal on Dev1 to be /Dev2/Engine0/SourceCompleteEvent, where edge

ViInt32 Specifies whether to configure the Source trigger to assert on the rising or falling edge.
Defined Values:
NIDCPOWER_VAL_RISING (1016) Asserts the trigger on the rising edge of the digital signal.
NIDCPOWER_VAL_FALLING (1017) Asserts the trigger on the falling edge of the digital signal.

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.

niDCPower_ConfigureDigitalEdgeSourceTrigger

ViStatus niDCPower_ConfigureDigitalEdgeSourceTrigger(ViSession vi, ViConstString inputTerminal, ViInt32 edge);

Purpose

This function is deprecated. Use niDCPower_ConfigureDigitalEdgeSourceTriggerWithChannels instead.

Configures the Source trigger for digital edge triggering.

Note  This function is not supported on all devices. Refer to Supported Functions by Device for more information about supported devices.

Parameters

Input
Name Type Description
vi ViSession Identifies a particular instrument session. vi is obtained from the niDCPower_InitializeWithIndependentChannels function.
inputTerminal ViConstString

Specifies the input terminal for the digital edge Source trigger.

You can specify any valid input terminal for this function. Valid terminals are listed in MAX under the Device Routes tab. For the PXIe-4147 and PXIe-4162/4163, refer to the Signal Routing topic for the device to determine which routes are available. This information is not available on a Device Routes tab in MAX.

Input terminals can be specified in one of two ways. If the device is named Dev1 and your terminal is PXI_Trig0, you can specify the terminal with the fully qualified terminal name, /Dev1/PXI_Trig0, or with the shortened terminal name, PXI_Trig0. The input terminal can also be a terminal from another device. For example, you can set the input terminal on Dev1 to be /Dev2/SourceCompleteEvent.

edge ViInt32 Specifies whether to configure the Source trigger to assert on the rising or falling edge.
Defined Values:
NIDCPOWER_VAL_RISING (1016) Asserts the trigger on the rising edge of the digital signal.
NIDCPOWER_VAL_FALLING (1017) Asserts the trigger on the falling edge of the digital signal.

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.

niDCPower_ConfigureSoftwareEdgeSourceTriggerWithChannels

ViStatus niDCPower_ConfigureSoftwareEdgeSourceTriggerWithChannels(ViSession vi);

Purpose

Configures the Source trigger for software edge triggering. Use the niDCPower_SendSoftwareEdgeTriggerWithChannels function to assert the trigger condition.

Note  This function is not supported on all devices. Refer to Supported Functions by Device for more information about supported devices.

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.

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.

niDCPower_ConfigureSoftwareEdgeSourceTrigger

ViStatus niDCPower_ConfigureSoftwareEdgeSourceTrigger(ViSession vi);

Purpose

This function is deprecated. Use niDCPower_ConfigureSoftwareEdgeSourceTriggerWithChannels instead.

Configures the Source trigger for software triggering. Use the niDCPower_SendSoftwareEdgeTrigger function to assert the trigger condition.

Note  This function is not supported on all devices. Refer to Supported Functions by Device for more information about supported devices.

Parameters

Input
Name Type Description
vi ViSession Identifies a particular instrument session. vi is obtained from the niDCPower_InitializeWithIndependentChannels function.

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.

niDCPower_DisableSourceTriggerWithChannels

ViStatus niDCPower_DisableSourceTriggerWithChannels(ViSession vi);

Purpose

Disables the Source trigger. The specified channel(s) do not wait for a source trigger before performing a source operation.

This function is necessary only if you configured a Source trigger in the past and now want to disable it.

Note  This function is not supported on all devices. Refer to Supported Functions by Device for more information about supported devices.

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.

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.

niDCPower_DisableSourceTrigger

ViStatus niDCPower_DisableSourceTrigger(ViSession vi);

Purpose

This function is deprecated. Use niDCPower_DisableSourceTriggerWithChannels instead.

Disables the Source trigger. The device does not wait for a source trigger before performing a source operation. Refer to the Single Point Source Mode topics for more information about the Source trigger.

Note  This function is not supported on all devices. Refer to Supported Functions by Device for more information about supported devices.

Parameters

Input
Name Type Description
vi ViSession Identifies a particular instrument session. vi is obtained from the niDCPower_InitializeWithIndependentChannels function.

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.

niDCPower_ConfigureDigitalEdgeMeasureTriggerWithChannels

ViStatus niDCPower_ConfigureDigitalEdgeMeasureTriggerWithChannels(ViSession vi, ViConstString inputTerminal, ViInt32 edge);

Purpose

Configures the Measure trigger for digital edge triggering.

Note  This function is not supported on all devices. Refer to Supported Functions by Device for more information about supported devices.

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.

inputTerminal ViConstString

Specifies the input terminal for the digital edge Measure trigger.

You can specify any valid input terminal for this function. Valid terminals are listed in MAX under the Device Routes tab. For the PXIe-4147 and PXIe-4162/4163, refer to the Signal Routing topic for the device to determine which routes are available. This information is not available on a Device Routes tab in MAX.

Specify the input terminal using the form /Dev1/PXI_Trig0, where Dev1 is the instrument and PXI_Trig0 is the terminal. The input terminal can also be a terminal from another instrument or channel. For example, you can set the input terminal on Dev1 to be /Dev2/Engine0/SourceCompleteEvent, where Engine0 is channel 0.

edge ViInt32 Specifies whether to configure the Measure trigger to assert on the rising or falling edge.
Defined Values:
NIDCPOWER_VAL_RISING (1016) Asserts the trigger on the rising edge of the digital signal.
NIDCPOWER_VAL_FALLING (1017) Asserts the trigger on the falling edge of the digital signal.

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.

niDCPower_ConfigureDigitalEdgeMeasureTrigger

ViStatus niDCPower_ConfigureDigitalEdgeMeasureTrigger(ViSession vi, ViConstString inputTerminal, ViInt32 edge);

Purpose

This function is deprecated. Use niDCPower_ConfigureDigitalEdgeMeasureTriggerWithChannels instead.

Configures the Measure trigger for digital edge triggering.

Note  This function is not supported on all devices. Refer to Supported Functions by Device for more information about supported devices.

Parameters

Input
Name Type Description
vi ViSession Identifies a particular instrument session. vi is obtained from the niDCPower_InitializeWithIndependentChannels function.
inputTerminal ViConstString

Specifies the input terminal for the digital edge Measure trigger.

You can specify any valid input terminal for this function. Valid terminals are listed in MAX under the Device Routes tab. For PXIe-4147 and PXIe-4162/4163, refer to the Signal Routing topic for the device to determine which routes are available. This information is not available on a Device Routes tab in MAX.

Input terminals can be specified in one of two ways. If the device is named Dev1 and your terminal is PXI_Trig0, you can specify the terminal with the fully qualified terminal name, /Dev1/PXI_Trig0, or with the shortened terminal name, PXI_Trig0. The input terminal can also be a terminal from another device. For example, you can set the input terminal on Dev1 to be /Dev2/SourceCompleteEvent.

edge ViInt32 Specifies whether to configure the Measure trigger to assert on the rising or falling edge.
Defined Values:
NIDCPOWER_VAL_RISING (1016) Asserts the trigger on the rising edge of the digital signal.
NIDCPOWER_VAL_FALLING (1017) Asserts the trigger on the falling edge of the digital signal.

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.

niDCPower_ConfigureSoftwareEdgeMeasureTriggerWithChannels

ViStatus niDCPower_ConfigureSoftwareEdgeMeasureTriggerWithChannels(ViSession vi);

Purpose

Configures the Measure trigger for software edge triggering. Use the niDCPower_SendSoftwareEdgeTriggerWithChannels function to assert the trigger condition.

Note  This function is not supported on all devices. Refer to Supported Functions by Device for more information about supported devices.

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.

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.

niDCPower_ConfigureSoftwareEdgeMeasureTrigger

ViStatus niDCPower_ConfigureSoftwareEdgeMeasureTrigger(ViSession vi);

Purpose

This function is deprecated. Use niDCPower_ConfigureSoftwareEdgeMeasureTriggerWithChannels instead.

Configures the Measure trigger for software triggering. Use the niDCPower_SendSoftwareEdgeTrigger function to assert the trigger condition.

Note  This function is not supported on all devices. Refer to Supported Functions by Device for more information about supported devices.

Parameters

Input
Name Type Description
vi ViSession Identifies a particular instrument session. vi is obtained from the niDCPower_InitializeWithIndependentChannels function.

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.

niDCPower_ConfigureDigitalEdgeSequenceAdvanceTriggerWithChannels

ViStatus niDCPower_ConfigureDigitalEdgeSequenceAdvanceTriggerWithChannels(ViSession vi, ViConstString inputTerminal, ViInt32 edge);

Purpose

Configures the Sequence Advance trigger for digital edge triggering.

Note  This function is not supported on all devices. Refer to Supported Functions by Device for more information about supported devices.

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.

inputTerminal ViConstString

Specifies the input terminal for the digital edge Sequence Advance trigger.

You can specify any valid input terminal for this function. Valid terminals are listed in MAX under the Device Routes tab. For the PXIe-4147 and PXIe-4162/4163, refer to the Signal Routing topic for the device to determine which routes are available. This information is not available on a Device Routes tab in MAX.

Specify the input terminal using the form /Dev1/PXI_Trig0, where Dev1 is the instrument and PXI_Trig0 is the terminal. The input terminal can also be a terminal from another instrument or channel. For example, you can set the input terminal on Dev1 to be /Dev2/Engine0/SourceCompleteEvent, where Engine0 is channel 0.

edge ViInt32 Specifies whether to configure the Sequence Advance trigger to assert on the rising or falling edge.

Defined Values:
NIDCPOWER_VAL_RISING (1016) Asserts the trigger on the rising edge of the digital signal.
NIDCPOWER_VAL_FALLING (1017) Asserts the trigger on the falling edge of the digital signal.

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.

niDCPower_ConfigureDigitalEdgeSequenceAdvanceTrigger

ViStatus niDCPower_ConfigureDigitalEdgeSequenceAdvanceTrigger(ViSession vi, ViConstString inputTerminal, ViInt32 edge);

Purpose

This function is deprecated. Use niDCPower_ConfigureDigitalEdgeSequenceAdvanceTriggerWithChannels instead.

Configures the Sequence Advance trigger for digital edge triggering.

Note  This function is not supported on all devices. Refer to Supported Functions by Device for more information about supported devices.

Parameters

Input
Name Type Description
vi ViSession Identifies a particular instrument session. vi is obtained from the niDCPower_InitializeWithIndependentChannels function.
inputTerminal ViConstString

Specifies the input terminal for the digital edge Sequence Advance trigger.

You can specify any valid input terminal for this function. Valid terminals are listed in MAX under the Device Routes tab. For PXIe-4147 and PXIe-4162/4163, refer to the Signal Routing topic for the device to determine which routes are available. This information is not available on a Device Routes tab in MAX.

Input terminals can be specified in one of two ways. If the device is named Dev1 and your terminal is PXI_Trig0, you can specify the terminal with the fully qualified terminal name, /Dev1/PXI_Trig0, or with the shortened terminal name, PXI_Trig0. The input terminal can also be a terminal from another device. For example, you can set the input terminal on Dev1 to be /Dev2/SourceCompleteEvent.

edge ViInt32 Specifies whether to configure the Sequence Advance trigger to assert on the rising or falling edge.

Defined Values:
NIDCPOWER_VAL_RISING (1016) Asserts the trigger on the rising edge of the digital signal.
NIDCPOWER_VAL_FALLING (1017) Asserts the trigger on the falling edge of the digital signal.

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.

niDCPower_ConfigureSoftwareEdgeSequenceAdvanceTriggerWithChannels

ViStatus niDCPower_ConfigureSoftwareEdgeSequenceAdvanceTriggerWithChannels(ViSession vi);

Purpose

Configures the Sequence Advance trigger for software edge triggering. Use the niDCPower_SendSoftwareEdgeTriggerWithChannels function to assert the trigger condition.

Note  This function is not supported on all devices. Refer to Supported Functions by Device for more information about supported devices.

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.

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.

niDCPower_ConfigureSoftwareEdgeSequenceAdvanceTrigger

ViStatus niDCPower_ConfigureSoftwareEdgeSequenceAdvanceTrigger(ViSession vi);

Purpose

This function is deprecated. Use niDCPower_ConfigureSoftwareEdgeSequenceAdvanceTriggerWithChannels instead.

Configures the Sequence Advance trigger for software triggering. Use the niDCPower_SendSoftwareEdgeTrigger function to assert the trigger condition.

Note  This function is not supported on all devices. Refer to Supported Functions by Device for more information about supported devices.

Parameters

Input
Name Type Description
vi ViSession Identifies a particular instrument session. vi is obtained from the niDCPower_InitializeWithIndependentChannels function.

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.

niDCPower_DisableSequenceAdvanceTriggerWithChannels

ViStatus niDCPower_DisableSequenceAdvanceTriggerWithChannels(ViSession vi);

Purpose

Disables the Sequence Advance trigger. The specified channel(s) do not wait for a Sequence Advance trigger before advancing to the next iteration of the sequence.

This function is necessary only if you configured a Sequence Advance trigger in the past and now want to disable it.

Note  This function is not supported on all devices. Refer to Supported Functions by Device for more information about supported devices.

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.

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.

niDCPower_DisableSequenceAdvanceTrigger

ViStatus niDCPower_DisableSequenceAdvanceTrigger(ViSession vi);

Purpose

This function is deprecated. Use niDCPower_DisableSequenceAdvanceTriggerWithChannels instead.

Disables the Sequence Advance trigger. The device does not wait for a Sequence Advance trigger before advancing to the next iteration of the sequence. Refer to the Sequence Source Mode topic for more information about the Sequence Advance trigger.

Note  This function is not supported on all devices. Refer to Supported Functions by Device for more information about supported devices.

Parameters

Input
Name Type Description
vi ViSession Identifies a particular instrument session. vi is obtained from the niDCPower_InitializeWithIndependentChannels function.

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.

niDCPower_ConfigureDigitalEdgePulseTriggerWithChannels

ViStatus niDCPower_ConfigureDigitalEdgePulseTriggerWithChannels(ViSession vi, ViConstString inputTerminal, ViInt32 edge);

Purpose

Configures the Pulse trigger for digital edge triggering.

Note  This function is not supported on all devices. Refer to Supported Functions by Device for more information about supported devices

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.

inputTerminal ViConstString

Specifies the input terminal for the digital edge Pulse trigger.

You can specify any valid input terminal for this function. Valid terminals are listed in MAX under the Device Routes tab. For the PXIe-4147 and PXIe-4162/4163, refer to the Signal Routing topic for the device to determine which routes are available. This information is not available on a Device Routes tab in MAX.

Specify the input terminal using the form /Dev1/PXI_Trig0, where Dev1 is the instrument and PXI_Trig0 is the terminal. The input terminal can also be a terminal from another instrument or channel. For example, you can set the input terminal on Dev1 to be /Dev2/Engine0/SourceCompleteEvent.

edge ViInt32 Specifies whether to configure the Pulse trigger to assert on the rising or falling edge.

Defined Values:
NIDCPOWER_VAL_RISING (1016) Asserts the trigger on the rising edge of the digital signal.
NIDCPOWER_VAL_FALLING (1017) Asserts the trigger on the falling edge of the digital signal.

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.

niDCPower_ConfigureDigitalEdgePulseTrigger

ViStatus niDCPower_ConfigureDigitalEdgePulseTrigger(ViSession vi, ViConstString inputTerminal, ViInt32 edge);

Purpose

This function is deprecated. Use niDCPower_ConfigureDigitalEdgePulseTriggerWithChannels instead.

Configures the Pulse trigger for digital edge triggering.

Note  This function is not supported on all devices. Refer to Supported Functions by Device for more information about supported devices

Parameters

Input
Name Type Description
vi ViSession Identifies a particular instrument session. vi is obtained from the niDCPower_InitializeWithIndependentChannels function.
inputTerminal ViConstString

Specifies the input terminal for the digital edge Pulse trigger.

You can specify any valid input terminal for this function. Valid terminals are listed in MAX under the Device Routes tab.

Input terminals can be specified in one of two ways. If the device is named Dev1 and your terminal is PXI_Trig0, you can specify the terminal with the fully qualified terminal name, /Dev1/PXI_Trig0, or with the shortened terminal name, PXI_Trig0. The input terminal can also be a terminal from another device. For example, you can set the input terminal on Dev1 to be /Dev2/SourceCompleteEvent, where Engine0 is channel 0.

edge ViInt32 Specifies whether to configure the Pulse trigger to assert on the rising or falling edge.

Defined Values:
NIDCPOWER_VAL_RISING (1016) Asserts the trigger on the rising edge of the digital signal.
NIDCPOWER_VAL_FALLING (1017) Asserts the trigger on the falling edge of the digital signal.

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.

niDCPower_ConfigureSoftwareEdgePulseTriggerWithChannels

ViStatus niDCPower_ConfigureSoftwareEdgePulseTriggerWithChannels(ViSession vi);

Purpose

Configures the Pulse trigger for software edge triggering. Use the niDCPower_SendSoftwareEdgeTriggerWithChannels function to assert the trigger condition.

Note  This function is not supported on all devices. Refer to Supported Functions by Device for more information about supported devices

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.

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.

niDCPower_ConfigureSoftwareEdgePulseTrigger

ViStatus niDCPower_ConfigureSoftwareEdgePulseTrigger(ViSession vi);

Purpose

This function is deprecated. Use niDCPower_ConfigureSoftwareEdgePulseTriggerWithChannels instead.

Configures the Pulse trigger for software triggering. Use the niDCPower_SendSoftwareEdgeTrigger function to assert the trigger condition.

Note  This function is not supported on all devices. Refer to Supported Functions by Device for more information about supported devices

Parameters

Input
Name Type Description
vi ViSession Identifies a particular instrument session. vi is obtained from the niDCPower_InitializeWithIndependentChannels function.

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.

niDCPower_DisablePulseTriggerWithChannels

ViStatus niDCPower_DisablePulseTriggerWithChannels(ViSession vi);

Purpose

Disables the Pulse trigger. The specified channel(s) do not wait for a pulse trigger before performing a pulse operation.

This function is necessary only if you configured a Pulse trigger in the past and now want to disable it.

Note  This function is not supported on all devices. Refer to Supported Functions by Device for more information about supported devices

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.

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.

niDCPower_DisablePulseTrigger

ViStatus niDCPower_DisablePulseTrigger(ViSession vi);

Purpose

This function is deprecated. Use niDCPower_DisablePulseTriggerWithChannels instead.

Disables the Pulse trigger. The device does not wait for a pulse trigger before performing a pulse operation. Refer to Pulse Mode for more information about the Pulse trigger.

This function is necessary only if you configured a Pulse trigger in the past and now want to disable it.

Note  This function is not supported on all devices. Refer to Supported Functions by Device for more information about supported devices

Parameters

Input
Name Type Description
vi ViSession Identifies a particular instrument session. vi is obtained from the niDCPower_InitializeWithIndependentChannels function.

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.

niDCPower_ConfigureDigitalEdgeShutdownTriggerWithChannels

ViStatus niDCPower_ConfigureDigitalEdgeShutdownTriggerWithChannels(ViSession vi, ViConstString inputTerminal, ViInt32 edge);

Purpose

Configures the Shutdown trigger for digital edge triggering.

Note  This function is not supported on all devices. Refer to Supported Functions by Device for more information about supported devices

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.

inputTerminal ViConstString

Specifies the input terminal for the digital edge Shutdown trigger.

You can specify any valid input terminal for this function. Valid terminals are listed in MAX under the Device Routes tab. For the PXIe-4147 and PXIe-4162/4163, refer to the Signal Routing topic for the device to determine which routes are available. This information is not available on a Device Routes tab in MAX.

Specify the input terminal using the form /Dev1/PXI_Trig0, where Dev1 is the instrument and PXI_Trig0 is the terminal. The input terminal can also be a terminal from another instrument or channel. For example, you can set the input terminal on Dev1 to be /Dev2/Engine0/SourceCompleteEvent, where Engine0 is channel 0.

edge ViInt32 Specifies whether to configure the Shutdown trigger to assert on the rising or falling edge.

Defined Values:
NIDCPOWER_VAL_RISING (1016) Asserts the trigger on the rising edge of the digital signal.
NIDCPOWER_VAL_FALLING (1017) Asserts the trigger on the falling edge of the digital signal.

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.

niDCPower_ConfigureSoftwareEdgeShutdownTriggerWithChannels

ViStatus niDCPower_ConfigureSoftwareEdgeShutdownTriggerWithChannels(ViSession vi);

Purpose

Configures the Shutdown trigger for software edge triggering. Use the niDCPower_SendSoftwareEdgeTriggerWithChannels function to assert the trigger condition.

Note  This function is not supported on all devices. Refer to Supported Functions by Device for more information about supported devices

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.

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.

niDCPower_DisableShutdownTriggerWithChannels

ViStatus niDCPower_DisableShutdownTriggerWithChannels(ViSession vi);

Purpose

Disables the Shutdown trigger. The specified channel(s) do not wait for a Shutdown trigger.

This function is necessary only if you configured a Shutdown trigger in the past and now want to disable it.

Note  This function is not supported on all devices. Refer to Supported Functions by Device for more information about supported devices

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.

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.

niDCPower_ExportSignalWithChannels

ViStatus niDCPower_ExportSignalWithChannels(ViSession vi, ViInt32 signal, ViConstString signalIdentifier, ViConstString outputTerminal);

Purpose

Routes signals (triggers and events) to the output terminal you specify. The route is created when the specified channel is committed.

Note  This function is not supported on all devices. Refer to Supported Functions by Device for more information about supported devices Related Topics:

Triggers

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.

signal ViInt32 Specifies which trigger or event to export.

Defined Values:
NIDCPOWER_VAL_SOURCE_COMPLETE_EVENT (1030) Exports the Source Complete event.
NIDCPOWER_VAL_MEASURE_COMPLETE_EVENT (1031) Exports the Measure Complete event.
NIDCPOWER_VAL_SEQUENCE_ITERATION_COMPLETE_EVENT (1032) Exports the Sequence Iteration Complete event.
NIDCPOWER_VAL_SEQUENCE_ENGINE_DONE_EVENT (1033) Exports the Sequence Engine Done event.
NIDCPOWER_VAL_PULSE_COMPLETE_EVENT (1051) Exports the Pulse Complete event.
NIDCPOWER_VAL_READY_FOR_PULSE_TRIGGER_EVENT (1052) Exports the Ready Pulse Trigger event.
NIDCPOWER_VAL_START_TRIGGER (1034) Exports the Start trigger.
NIDCPOWER_VAL_SOURCE_TRIGGER (1035) Exports the Source trigger.
NIDCPOWER_VAL_MEASURE_TRIGGER (1036) Exports the Measure trigger.
NIDCPOWER_VAL_SEQUENCE_ADVANCE_TRIGGER (1037) Exports the Sequence Advance trigger.
NIDCPOWER_VAL_PULSE_TRIGGER (1053) Exports the Pulse trigger.
signalIdentifier ViConstString Reserved for future use. Pass in an empty string for this parameter.
outputTerminal ViConstString Specifies where to export the selected signal.

Relative Terminals:
"" Do not export signal
"PXI_Trig0" PXI trigger line 0
"PXI_Trig1" PXI trigger line 1
"PXI_Trig2" PXI trigger line 2
"PXI_Trig3" PXI trigger line 3
"PXI_Trig4" PXI trigger line 4
"PXI_Trig5" PXI trigger line 5
"PXI_Trig6" PXI trigger line 6
"PXI_Trig7" PXI trigger line 7

You can also supply a fully qualified terminal name to this control, for example, /Dev1/PXI_Trig0, or /Dev1/Engine0/PXI_Trig0, where Engine0 is channel 0.

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.

niDCPower_ExportSignal

ViStatus niDCPower_ExportSignal(ViSession vi, ViInt32 signal, ViConstString signalIdentifier, ViConstString outputTerminal);

Purpose

This function is deprecated. Use niDCPower_ExportSignalWithChannels instead.

Routes signals (triggers and events) to the output terminal you specify. The route is created when the session is committed.

Note  This function is not supported on all devices. Refer to Supported Functions by Device for more information about supported devices Related Topics:

Triggers

Parameters

Input
Name Type Description
vi ViSession Identifies a particular instrument session. vi is obtained from the niDCPower_InitializeWithIndependentChannels function.
signal ViInt32 Specifies which trigger or event to export.

Defined Values:
NIDCPOWER_VAL_SOURCE_COMPLETE_EVENT (1030) Exports the Source Complete event.
NIDCPOWER_VAL_MEASURE_COMPLETE_EVENT (1031) Exports the Measure Complete event.
NIDCPOWER_VAL_SEQUENCE_ITERATION_COMPLETE_EVENT (1032) Exports the Sequence Iteration Complete event.
NIDCPOWER_VAL_SEQUENCE_ENGINE_DONE_EVENT (1033) Exports the Sequence Engine Done event.
NIDCPOWER_VAL_PULSE_COMPLETE_EVENT (1051) Exports the Pulse Complete event.
NIDCPOWER_VAL_READY_FOR_PULSE_TRIGGER_EVENT (1052) Exports the Ready Pulse Trigger event.
NIDCPOWER_VAL_START_TRIGGER (1034) Exports the Start trigger.
NIDCPOWER_VAL_SOURCE_TRIGGER (1035) Exports the Source trigger.
NIDCPOWER_VAL_MEASURE_TRIGGER (1036) Exports the Measure trigger.
NIDCPOWER_VAL_SEQUENCE_ADVANCE_TRIGGER (1037) Exports the Sequence Advance trigger.
NIDCPOWER_VAL_PULSE_TRIGGER (1053) Exports the Pulse trigger.
signalIdentifier ViConstString Reserved for future use. Pass in an empty string for this parameter.
outputTerminal ViConstString Specifies where to export the selected signal.

Relative Terminals:
"" Do not export signal
"PXI_Trig0" PXI trigger line 0
"PXI_Trig1" PXI trigger line 1
"PXI_Trig2" PXI trigger line 2
"PXI_Trig3" PXI trigger line 3
"PXI_Trig4" PXI trigger line 4
"PXI_Trig5" PXI trigger line 5
"PXI_Trig6" PXI trigger line 6
"PXI_Trig7" PXI trigger line 7

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.

niDCPower_SendSoftwareEdgeTriggerWithChannels

ViStatus niDCPower_SendSoftwareEdgeTriggerWithChannels(ViSession vi, ViInt32 trigger);

Purpose

Asserts the specified trigger. This function can override an external edge trigger.

Note  This function is not supported on all devices. Refer to Supported Functions by Device for more information about supported devices Related Topics:

Triggers

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.

trigger ViInt32 Specifies which trigger to assert.

Defined Values:
NIDCPOWER_VAL_START_TRIGGER (1034) Asserts the Start trigger.
NIDCPOWER_VAL_SOURCE_TRIGGER (1035) Asserts the Source trigger.
NIDCPOWER_VAL_MEASURE_TRIGGER (1036) Asserts the Measure trigger.
NIDCPOWER_VAL_SEQUENCE_ADVANCE_TRIGGER (1037) Asserts the Sequence Advance trigger.
NIDCPOWER_VAL_PULSE_TRIGGER (1053) Asserts the Pulse trigger.
NIDCPOWER_VAL_SHUTDOWN_TRIGGER (1118) Asserts the Shutdown trigger.

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.

niDCPower_SendSoftwareEdgeTrigger

ViStatus niDCPower_SendSoftwareEdgeTrigger(ViSession vi, ViInt32 trigger);

Purpose

This function is deprecated. Use niDCPower_SendSoftwareEdgeTriggerWithChannels instead.

Asserts the specified trigger. This function can override an external edge trigger.

Note  This function is not supported on all devices. Refer to Supported Functions by Device for more information about supported devices Related Topics:

Triggers

Parameters

Input
Name Type Description
vi ViSession Identifies a particular instrument session. vi is obtained from the niDCPower_InitializeWithIndependentChannels function.
trigger ViInt32 Specifies which trigger to assert.

Defined Values:
NIDCPOWER_VAL_START_TRIGGER (1034) Asserts the Start trigger.
NIDCPOWER_VAL_SOURCE_TRIGGER (1035) Asserts the Source trigger.
NIDCPOWER_VAL_MEASURE_TRIGGER (1036) Asserts the Measure trigger.
NIDCPOWER_VAL_SEQUENCE_ADVANCE_TRIGGER (1037) Asserts the Sequence Advance trigger.
NIDCPOWER_VAL_PULSE_TRIGGER (1053 Asserts the Pulse trigger.

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.

niDCPower_WaitForEventWithChannels

ViStatus niDCPower_WaitForEventWithChannels(ViSession vi, ViInt32 eventId, ViReal64 timeout);

Purpose

Waits until the specified channel(s) have generated the specified event.

The session monitors whether each type of event has occurred at least once for the specified channel(s) since the last time this function or the niDCPower_InitiateWithChannels function were called. If an event has only been generated once and you call this function successively, the function times out. Individual events must be generated between separate calls of this function.

Note  Refer to Supported Functions by Device for more information about supported devices

Related topics:

Programming States

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.

eventId ViInt32 Specifies which event to wait for.

Defined Values:
NIDCPOWER_VAL_SOURCE_COMPLETE_EVENT (1030) Waits for the Source Complete event.
NIDCPOWER_VAL_MEASURE_COMPLETE_EVENT (1031) Waits for the Measure Complete event.
NIDCPOWER_VAL_SEQUENCE_ITERATION_COMPLETE_EVENT (1032) Waits for the Sequence Iteration Complete event.
NIDCPOWER_VAL_SEQUENCE_ENGINE_DONE_EVENT (1033) Waits for the Sequence Engine Done event.
NIDCPOWER_VAL_PULSE_COMPLETE_EVENT (1051) Waits for the Pulse Complete event.
NIDCPOWER_VAL_READY_FOR_PULSE_TRIGGER_EVENT (1052) Waits for the Ready for Pulse Trigger event.
timeout ViReal64 Specifies the maximum time allowed for this function to complete, in seconds. If the function does not complete within this time interval, NI-DCPower returns an error.

Note  When setting the timeout interval, ensure you take into account any triggers so that the timeout interval is long enough for your application

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.

niDCPower_WaitForEvent

ViStatus niDCPower_WaitForEvent(ViSession vi, ViInt32 eventId, ViReal64 timeout);

Purpose

This function is deprecated. Use niDCPower_WaitForEventWithChannels instead.

Waits until the device has generated the specified event.

The session monitors whether each type of event has occurred at least once since the last time this function or the niDCPower_Initiate function were called. If an event has only been generated once and you call this function successively, the function times out. Individual events must be generated between separate calls of this function.

Note  This function should only be called in the Running state. Refer to the Programming States Diagram for more information

Note  Refer to Supported Functions by Device for more information about supported devices

Parameters

Input
Name Type Description
vi ViSession Identifies a particular instrument session. vi is obtained from the niDCPower_InitializeWithIndependentChannels function.
eventId ViInt32 Specifies which event to wait for.

Defined Values:
NIDCPOWER_VAL_SOURCE_COMPLETE_EVENT (1030) Waits for the Source Complete event.
NIDCPOWER_VAL_MEASURE_COMPLETE_EVENT (1031) Waits for the Measure Complete event.
NIDCPOWER_VAL_SEQUENCE_ITERATION_COMPLETE_EVENT (1032) Waits for the Sequence Iteration Complete event.
NIDCPOWER_VAL_SEQUENCE_ENGINE_DONE_EVENT (1033) Waits for the Sequence Engine Done event.
NIDCPOWER_VAL_PULSE_COMPLETE_EVENT (1051 ) Waits for the Pulse Complete event.
NIDCPOWER_VAL_READY_FOR_PULSE_TRIGGER_EVENT (1052) Waits for the Ready for Pulse Trigger event.

|timeout|ViReal64|Specifies the maximum time allowed for this function to complete, in seconds. If the function does not complete within this time interval, NI-DCPower returns an error.|

Note  When setting the timeout interval, ensure you take into account any triggers so that the timeout interval is long enough for your application

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.
⚠️ **GitHub.com Fallback** ⚠️