Teledyne Princeton Instruments PICam 5.x, Руководство программиста

Страница: 24 / 357

24 PICam™ 5.x Programmer’s Manual Issue 11
3.2 Programmers’ Reference for General Use Library APIs
This section provides a detailed programmers’ reference guide for the following APIs,
including their syntax and behavior:
• Library Version
— Picam_GetVersion()
• Library Initialization
— Picam_IsLibraryInitialized()
— Picam_InitializeLibrary()
— Picam_UninitializeLibrary()
• General String Handling
— Picam_DestroyString()
— Picam_GetEnumerationString()
3.2.1
Picam_GetVersion()
Description
Picam_GetVersion()
returns PICam version information.
The following version information may be requested:
• Major
This is the Major release version which is incremented with each major feature
addition or breaks backward-compatibility.
• Minor
This is the Minor release version which is incremented with minor feature
additions.
• Distribution
This is the Distribution version which is incremented with bug fix releases.
• Released
This is the date of the current official release in the format YYMM.
When a release is classified as a Beta release, requesting this information returns
a zero (
0
).
NOTE:
Picam_GetVersion()
may be called prior to initializing the
library with
Picam_InitializeLibrary()
.
Syntax
The syntax of
Picam_GetVersion()
is:
PICAM_API Picam_GetVersion(
piint* major,
piint* minor,
piint* distribution,
piint* released);
continued on next page