Teledyne Princeton Instruments PICam 5.x, Programmer'S Manual

Page: 61 / 357

Chapter 4 Identification APIs 61
4.3.3.2 Picam_GetFirmwareDetails()
Description
Picam_GetFirmwareDetails()
dynamically creates an array of length N. This array
stores firmware details associated with a specified camera ID.
NOTE:
Prior to program termination, memory that has been
dynamically allocated to
firmware_array
must be released
by calling
Picam_DestroyFirmwareDetails()
.
Syntax
The syntax for
Picam_GetFirmwareDetails()
is:
PICAM_API Picam_GetFirmwareDetails(
const PicamCameraID* id,
const PicamFirmwareDetail** firmware_array,
piint* firmware_count);
Input Parameters
Input parameters for
Picam_GetFirmwareDetails()
are:
Output Parameters
Output parameters for
Picam_GetFirmwareDetails()
are:
Related APIs
For additional information, refer to the following related APIs:
• Picam_DestroyFirmwareDetails() .
id: Camera id for which firmware details are to be retrieved.
firmware_array:
Pointer to the memory address for the array in which firmware
information is stored.
When no information is stored, a null value is returned.
firmware_count:
The total number of firmware details stored in
firmware_array
.
This equals the length of the array that has been created.
When no information is available, a value of 0 [zero] is returned.