Components All New MacOS Windows Linux iOS
Examples Mac & Win Server Client Guides Statistic FMM Blog Deprecated Old

ImageCapture.OpenDevice

Requests to open a session on the device.

Component Version macOS Windows Linux Server iOS SDK
ImageCapture 6.4 ✅ Yes ❌ No ❌ No ❌ No ❌ No
MBS( "ImageCapture.OpenDevice"; Device { ; Wait } )   More

Parameters

Parameter Description Example Flags
Device The device ID.
Can be zero based index in device list.
Or UUID, Name or persistent ID string.
0
Wait Pass 1 to wait till complete.
Or pass 0 to return immediately.
Default is 1 to wait.
0 Optional

Result

Returns OK or error.

Description

Requests to open a session on the device.
A client MUST open a session on a device in order to use the device.

If needed closes current device to open new device.
Added 20 seconds timeout for version 8.1.

With ImageCapture.DeviceInfo you can query hasOpenSession later to verify you have a session open.

Examples

Open device:

Set Variable [$r; Value:MBS("ImageCapture.OpenDevice"; Images::Device)]
If [MBS("iserror")]
    Show Custom Dialog ["Failed to open"; MBS("Text.RemovePrefix"; $r; "[MBS] ")]
    Exit Script []
End If

See also

Release notes

Example Databases

Blog Entries

This function checks for a license.

Created 11st September 2016, last changed 18th April 2024


ImageCapture.MediaFiles - ImageCapture.PDF