perClass Mira 5.3 Documentation

Returns the name of an available device.

const char* miraacq_GetDeviceName(makernel* pma, int deviceInd);

Parameters:

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

Return value:

The name of the device as string.

Description:

miraacq_GetDeviceName will return the name of an available device, 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. const int deviceCount = miraacq_GetDeviceCount(pma);
4. printf("%d devices:\n", deviceCount);
5. for (int i = 0; i < deviceCount; i++) {
6.     printf(" %d : %s\n", i, miraacq_GetDeviceName(pma, i));
7. }
8. 
   
9. Error:
10. if (res != MIRA_OK) {
11.     printf("Error %d: %s", miraacq_GetErrorCode(pma), miraacq_GetErrorMsg(pma));
12. }

Output:

1 devices:

 0 : MC023MG-SY-UB