NI-DAQmx .NET Framework 4.5 API Reference

CIChannelCollection.CreateGpsTimestampChannel Method (String, String, CIGpsSyncMethod, CITimestampUnits)

Download PDF

Updated2023-02-21
2 minute(s) read

Creates a CIChannel that uses a special purpose counter to take a timestamp and synchronize that counter to a GPS receiver. This method adds one channel to the CIChannelCollection.

Namespace: NationalInstruments.DAQmx
Assembly: NationalInstruments.DAQmx (in NationalInstruments.DAQmx.dll) Version: 20.7.45.49302

Syntax

public CIChannel CreateGpsTimestampChannel(
	string counter,
	string nameToAssignChannel,
	CIGpsSyncMethod method,
	CITimestampUnits units
)

Public Function CreateGpsTimestampChannel ( 
	counter As String,
	nameToAssignChannel As String,
	method As CIGpsSyncMethod,
	units As CITimestampUnits
) As CIChannel

Parameters

counter: Type: SystemString
The name of the counter to use to create the virtual channel.
nameToAssignChannel: Type: SystemString
The name to assign to the created channel. To use the physical channel name as the local virtual channel name, set this value to Empty.
method: Type: NationalInstruments.DAQmxCIGpsSyncMethod
The method to use to synchronize the counter to a GPS receiver.
units: Type: NationalInstruments.DAQmxCITimestampUnits
The units to use to return GPS timestamp measurements from the channel.

Return Value

Type: CIChannel
The newly created CIChannel.

Exceptions

Exception	Condition
DaqException	The NI-DAQmx driver returned an error.

Remarks

With the exception of devices that support multi-counter tasks, you can create only one CIChannel at a time with this function because a task can contain only one CIChannel. To read from multiple counters simultaneously, use a separate task for each counter.

This method creates a virtual channel for the physical channel name you specify.

If you do not provide a value for nameToAssignChannel, NI-DAQmx uses the counter as the local virtual channel name. If you use nameToAssignChannel to create a name for the local virtual channel, you must use this name in other properties and methods.

The NI-DAQmx driver does not determine if the requested settings are possible until the task is verified. CreateGpsTimestampChannel(String, String, CIGpsSyncMethod, CITimestampUnits) does not throw an exception for parameter values that are not compatible with your hardware or other settings in your task. To determine if all of the settings for a Task are valid, you must verify the task by starting the task, either with Start or by reading from or writing to the task, or by calling Control(TaskAction) with Verify.

NI-DAQmx .NET Framework 4.5 API Reference

Table of Contents

CIChannelCollection.CreateGpsTimestampChannel Method (String, String, CIGpsSyncMethod, CITimestampUnits)

Syntax

Parameters

Return Value

Exceptions

Remarks

See Also

Reference

Log in to get a better experience