IDashDevice
Interface for controlling a device.
Note that this object initially represents a device factory. i.e. it is an object which has the ability to create instances of a real device object internally to GDA for the purpose of executing various commands.
Contents
Properties
| Property | Description |
|---|---|
| Name | Gets the name of this device. |
| SerialNumber | Gets the device serial number. |
| Description | Gets the device description. |
| UsbVid | Gets the device USB PID. |
| UsbPid | Gets the device USB PID. |
Public Methods
| Function | Description |
|---|---|
| DownloadSetup | Start a setup download for this device. |
| UploadSetup | Start a setup upload for this device (programs opened setup into the device). |
| UploadFirmware | Start a firmware upload for this device. |
| EraseLog | Start an Erase Log operation for this device. |
| UploadSetupUnattended | Upload a setup without interactive prompts. |
Properties
Name
Gets the name of this device.
BSTR NameSerialNumber
Gets the device serial number.
BSTR SerialNumberDescription
Gets the device description.
BSTR DescriptionUsbVid
Gets the device USB PID.
int UsbVidUsbPid
Gets the device USB PID.
int UsbPidPublic Methods
Method: DownloadSetup
Start a setup download for this device.
HRESULT DownloadSetup([in] BSTR filename, [in, optional] VARIANT options, [out, retval] IDashJob **retval)Method: UploadSetup
Start a setup upload for this device (programs opened setup into the device).
HRESULT UploadSetup([in] BSTR filename, [in, optional] VARIANT options, [out, retval] IDashJob **retval)Method: UploadFirmware
Start a firmware upload for this device.
HRESULT UploadFirmware([in] BSTR filename, [in, optional] VARIANT options, [out, retval] IDashJob **retval)Method: EraseLog
Start an Erase Log operation for this device.
HRESULT EraseLog([in, optional] VARIANT options, [out, retval] IDashJob **retval)Method: UploadSetupUnattended
Upload a setup without interactive prompts.
HRESULT UploadSetupUnattended([in] BSTR filename, [in, optional] VARIANT options, [out, retval] IDashJob **retval)enableSetupDownload (default false).
checkFirmwareUpdate defaults to false. Setting it, acceptFirmwareUpdate, acceptEraseLog or rawSetup to true fails the job before device access. allowDisplayMismatch defaults to false; when true, a mismatch that the interactive uploader permits confirming is accepted with a warning.
Returns
S_OK when the job is created, E_INVALIDARG for an empty filename, E_POINTER for a null output, or a COM error if the setup cannot be opened. An unapproved display-type mismatch, nonempty log or excessive RAM requirement fails without a confirmation dialog.
A rejected job does not erase logs or program the device.
Keep the application and job references until completion or confirmed cancellation. Legacy versions do not expose this method; clients must check its DISPID before use.