perClass Mira 5.3 Documentation

Opens a device for acquisition.

int miraacq_OpenDevice(makernel* pma, int deviceInd);

Parameters:

• pma: A pointer to the acquisition kernel returned by miraacq_Init.
• deviceInd: Device index to open, must be less than miraacq_GetDeviceCount.

Return value:

MIRA_OK (0) or an error code.

Description:

miraacq_OpenDevice will open the specified device for acquisition, it requires that the devices have been scanned using miraacq_ScanDevices.

Example:

Note the MIRAACQ_CHECK macro, which will check if the return value was MIRA_OK (0) or an error code. In case of an error code, it will jump to a label called Error.

1. MIRAACQ_CHECK(miraacq_ScanDevices(pma));
2. 
   
3. int deviceInd = 0;
4. MIRAACQ_CHECK(miraacq_OpenDevice(pma, deviceInd));
5. printf("Device opened: %d '%s'\n", deviceInd, miraacq_GetDeviceName(pma, deviceInd));
6. 
   
7. Error:
8. if (res != MIRA_OK) {
9.     printf("Error %d: %s", miraacq_GetErrorCode(pma), miraacq_GetErrorMsg(pma));
10. }

Output:

Device opened: 0 'MC023MG-SY-UB'