niHSDIO_ConfigureInitialState

NI Digital Waveform Generator/Analyzer

niHSDIO_ConfigureInitialState

Specific Function

C Function Prototype

ViStatus niHSDIO_ConfigureInitialState (ViSession vi, ViConstString channelList, ViConstString initialState);

Purpose

Sets the Initial state for a dynamic generation operation. The Initial state of each channel is driven after the session is initiated using niHSDIO_Initiate. Channels remain unchanged until the first waveform sample is generated.

Valid Syntax:
Both of these examples are valid and do the same thing. The order of channelList determines the order of the pattern string.

Parameters

Name Type Description
vi ViSession This handle identifies your instrument session. vi was obtained from niHSDIO_InitGenerationSession.
channelList ViConstString Specifies which channels have their initial value set using the initialState string. The order of channels in channelList determines the order of the initialState string.
initialState ViConstString Describes the Initial state of a dynamic generation operation. This expression is composed of characters:
  • 'X' or 'x': keeps the previous value
  • '1': sets the channel to logic high
  • '0': sets the channel to logic low
  • 'Z' or 'z': disables the channel or sets it to high-impedance
Note  NI 656x devices do not support the high-impedance (Z) Initial state.
The first character in the expression corresponds to the first channel in channelList. The number of characters in pattern must equal the number of channels specified in channelList or an error is returned.

The default state of a channel is to keep the previous value.

Return Value