niHSDIO_TristateChannels

NI Digital Waveform Generator/Analyzer

niHSDIO_TristateChannels

Specific Function

C Function Prototype

ViStatus niHSDIO_TristateChannels (ViSession vi, ViConstString channelList, ViBoolean tristate);

Purpose

Use this function to force a channel into a high-impedance state. The effect is immediate—it does not require the session be committed. The channel will remain tristated regardless of what other software commands are called. Call this function again and pass VI_FALSE into the tristate parameter to allow other software commands to control the channel normally.

Channels are kept in a high-impedance state while the session remains open. Closing the session does not affect the high-impedance state of the channel, but future sessions can now control it.

Parameters

Name Type Description
vi ViSession This handle identifies your instrument session. vi was obtained from niHSDIO_InitGenerationSession.
channelList ViConstString This string identifies which channels will be tristated. Channels not specified in this list are unaffected.

Syntax examples: "2-15" or "0-3, 5, 8-15" or "0, 3, 10"
tristate ViBoolean Specifies whether the channels specified in channelList remain tristated, ignoring future software commands.

Defined Values

VI_TRUE (1)—The channels specified in channelList remain tristated, ignoring future software commands.
VI_FALSE (0)—The channels specified in channelList are untristated by future software commands.

Default Value: VI_TRUE

Return Value