niHSDIO_ConfigureDataPosition

Specific Function

C Function Prototype

ViStatus niHSDIO_ConfigureDataPosition (ViSession vi, ViConstString channelList, ViInt32 position);

Purpose

Configures channels to be clocked in various ways by the Sample clock edges. You have three options for data position: rising edge, falling edge, or delayed.

Parameters

Name	Type	Description
vi	ViSession	This handle identifies your instrument session. vi was obtained from the niHSDIO_InitAcquisitionSession or niHSDIO_InitGenerationSession function.
channelList	ViConstString	Identifies channels to apply settings. Use "" or VI_NULL to specify all channels.
position	ViInt32	Specifies which edge of the Sample clock signal times the operation. You can also configure the device to generate data at a configurable delay past each rising edge of the Sample clock. Defined Values NIHSDIO_VAL_SAMPLE_CLOCK_RISING_EDGE (18)—The device samples or generates data on the rising edge of the Sample clock. NIHSDIO_VAL_SAMPLE_CLOCK_FALLING_EDGE (19)—The device samples or generates data on the falling edge of the Sample clock. NIHSDIO_VAL_DELAY_FROM_SAMPLE_CLOCK_RISING_EDGE (20)—The device samples or generates data with delay from rising edge of the Sample clock. Specify the delay using NIHSDIO_ATTR_DATA_POSITION_DELAY or the niHSDIO_ConfigureDataPositionDelay function. Notes  NIHSDIO_VAL_DELAY_FROM_SAMPLE_CLOCK_RISING_EDGE has more jitter than the rising or falling edge values. Certain devices have sample clock frequency limitations when a custom delay is used. Refer to the device documentation for details. To configure a delay on NI 656x devices, you must delay all channels on the device. NI-HSDIO returns an error if you apply a delay to only a partial channel list. Default Value: NIHSDIO_VAL_SAMPLE_CLOCK_RISING_EDGE

Return Value