| Components | All | New | MacOS | Windows | Linux | iOS | ||||
| Examples | Mac & Win | Server | Client | Guides | Statistic | FMM | Blog | Deprecated | Old | |
ImageCapture.DeviceInfo
Queries information about device.
| Component | Version | macOS | Windows | Linux | Server | iOS SDK |
| ImageCapture | 6.4 | ✅ Yes | ❌ No | ❌ No | ❌ No | ❌ No |
MBS( "ImageCapture.DeviceInfo"; Device; Selector { ; ImageType; FileName } ) 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 | |
| Selector | Which value to query. | "name" | |
| ImageType | The type of image to return. Either JPEG, PNG, GIF or BMP. Default is JPEG. |
"JPEG" | Optional |
| FileName | The filename to use for the picture. Default is "image" with the extension matching the image type. |
"test.jpg" | Optional |
Result
Returns value or error.
Description
Queries information about device.| Selector | Description | Example |
| availableFunctionalUnitTypes | The available functional unit types for scanner. This can include Flatbed, DocumentFeeder, NegativeTransparency or PositiveTransparency. | "Flatbed¶DocumentFeeder" |
| name | Name of the device as reported by the device module or by the device transport when a device module is not in control of this device. This name may change if the device module overrides the default name of the device reported by the device's transport, or if the name of the filesystem volume mounted by the device is changed by the user. | "Brother DCP-8085DN" |
| type | The type of the device. Camera or Scanner | "Scanner" |
| modulePath | Filesystem path of the device module that is associated with this device. | |
| moduleVersion | The bundle version of the device module associated with this device. | "1.0" |
| remote | Indicates whether the device is a remote device published by Image Capture device sharing facility. Can be 1 or 0. | 1 |
| shared | Indicates whether the device is shared using the Image Capture device sharing facility. Can be 1 or 0. | 1 |
| hasConfigurableWiFiInterface | Indicates whether the device can be configured for use on a WiFi network. | 0 |
| transportType | The transport type used by the device. Can be USB, Bluetooth, TCPIP, MassStorage. | "USB" |
| serialNumberString | The serial number of the device. This will be NULL if the device does not provide a serial number. | "12345" |
| locationDescription | A non-localized location description string for the device. | "Best Scanner" |
| persistentIDString | A string representation of the persistent ID of the device. | "61B0A8E1-61B0-A8E1-61B0-A8E161B0A8E1" |
| UUIDString | A string representation of the Universally Unique ID of the device. | "61B0A8E1-61B0-A8E1-61B0-A8E161B0A8E1" |
| hasOpenSession | Indicates whether the device has an open session. Can be 1 or 0. | 0 |
| icon | Icon image for the device. | |
| moduleExecutableArchitecture | Executable Architecture of the device module in control of this device. | |
| usbLocationID | The USB location ID of a USB device in the IOKit registry. This will be 0 for non-USB devices. | |
| usbProductID | The USB product ID of a USB device in the IOKit registry. This will be 0 for non-USB devices. | |
| usbVendorID | The USB vendor ID of a USB device in the IOKit registry. This will be 0 for non-USB devices. | |
| fwGUID | The FireWire GUID of a FireWire device in the IOKit registry. This will be 0 for non-FireWire devices. | |
| buttonPressed | A string object with one of the ICButtonType* values defined above. | |
| autolaunchApplicationPath | Filesystem path of an application that is to be automatically launched when this device is added. | |
| capabilities | The capabilities of the device as reported by the device module. |
Added with plugin version 7.0: bonjourServiceName, bonjourServiceType, iconPath, ipAddress and productKind.
New for macOS 11.0: systemSymbolName allows to query standard system symbol used to represent the device class. Using the symbol to render an appropriate device icon will ensure proper scaling for high resolution devices.
Examples
Query remote status for first device:
MBS("ImageCapture.DeviceInfo"; 0; "remote")
Query shared status for first device:
MBS("ImageCapture.DeviceInfo"; 0; "shared")
Query serial number for first device:
MBS("ImageCapture.DeviceInfo"; 0; "serialNumberString")
Query location description for a device:
MBS("ImageCapture.DeviceInfo"; "61B0A8E1-61B0-A8E1-61B0-A8E161B0A8E1"; "locationDescription")
Query capabilities for a device:
MBS("ImageCapture.DeviceInfo"; "61B0A8E1-61B0-A8E1-61B0-A8E161B0A8E1"; "capabilities")
See also
- ImageCapture.CameraInfo
- ImageCapture.Devices
- ImageCapture.DevicesJSON
- ImageCapture.OpenDevice
- ImageCapture.PreferredDevice
Release notes
- Version 10.5
- Added SystemSymbolName selector for ImageCapture.DeviceInfo function.
Example Databases
Blog Entries
FileMaker Magazin
This function checks for a license.
Created 11st September 2016, last changed 18th April 2024
