niSwitch_InitiateScan

IviSwtchScanner Capability Group

C Function Prototype

ViStatus niSwitch_InitiateScan (ViSession vi);

Purpose

Commits the configured scan list and trigger settings to hardware and initiates the scan. If niSwitch_Commit was called earlier, niSwitch_InitiateScan only initiates the scan and returns immediately.

Once the scanning operation begins, you cannot perform any other operation other than GetAttribute, niSwitch_AbortScan, or niSwitch_SendSoftwareTrigger. All other functions return the NISWITCH_ERROR_SCAN_IN_PROGRESS error. To stop the scanning operation,

To stop the scanning operation, call niSwitch_AbortScan.

Parameters

Name	Type	Description
vi	ViSession	A particular NI-SWITCH session established with niSwitch_InitWithTopology, niSwitch_InitWithOptions, or niSwitch_init and used for all subsequent NI-SWITCH calls.