GetDeviceRef
Purpose
This function returns the device reference for a device. The device reference is different than an index to a device. The device reference is only needed for other procedures which explicitly require the device reference.
Parameters
Parameter: sAddress
Type: string
Description: This is the actual device code, such as "12345-A1", or "IOPOINT1"
Returns
Return value: reference
Type: Integer
Description: This is a numerical device reference.
Example
Sample Code
None
This will only return the reference to the first device matching the address provided. The address is the "Address" property of a device, not the code property. The Address is normally set by a plugin and can be used to find a device.