Is_Deviceinfo - THORLABS DCU223x Operation Manual And Sdk

DCx Cameras

4.3.16 is_DeviceInfo

USB 3
Note
This command is supported by DCC3240x USB3 cameras only!
Syntax
INT is_DeviceInfo (HIDS hCam, UINT nCommand, void* pParam, UINT cbSizeOfParam)
Description
Using is_DeviceInfo(), you can query information about connected USB 3 Cameras. The resulting information
is written to the IS_DEVICE_INFO structure. For this purpose, the cameras need not be opened.
The nCommand input parameter is used to select the function mode. The pParam input parameter depends on the
selected function mode. If you select functions for setting or returning a value, pParam contains a pointer to a
variable of the UINT type. The size of the memory area to which pParam refers is specified in the
cbSizeOfParam input parameter.
Input parameters
hCam
nCommand
IS_DEVICE_INFO_CMD_GET_DEVICE_INFO
pParam
cbSizeOfParam
Contents of the IS_DEVICE_INFO structure
IS_DEVICE_INFO_HEARTBEAT infoDevHeartbeat
IS_DEVICE_INFO_CONTROL
BYTE
Contents of the IS_DEVICE_INFO::IS_DEVICE_INFO_HEARTBEAT structure
BYTE reserved_1[36]
DWORD dwRuntimeFirmwareVersion
BYTE reserved_2[8]
WORD wTemperature
WORD wLinkSpeed_Mb
196
USB 3
Camera handle
Returns a information structure about the specified
device
Pointer to a function parameter, whose function depends
on nCommand.
Size (in bytes) of the memory area to which pParam
refers.
infoDevControl
reserved[240]
(Example 1 )
197
Camera-related data retrieved from the
camera (from the heartbeat telegram)
See
IS_DEVICE_INFO_HEARTBEAT
Camera-related driver data
See
IS_DEVICE_INFO_CONTROL
reserved
reserved
Firmware version
reserved
Camera temperature in degree Celsius
Bit 15: algebraic sign
Bit 14...11: filled according to algebraic sign
Bit 10...4: temperature (places before the
decimal point)
Bit 3...0: temperature (places after the
decimal point)
See the Ambient conditions
permissible temperature range.
Transfer rate:
IS_USB_HIGH_SPEED = 480
IS_USB_SUPER_SPEED = 4000
© 2013 Thorlabs GmbH
196
197
chapter for
486