User manual

114
In order to perform the operation, the initiator invokes a routine identified by the
get_product_copyright field of the chapi_in descriptor. The procedure should be invoked like
follows from device instance:
char *prod_copy_str;
…
if(ci && ci->get_product_copyright) {
prod_copy_str = ci->get_product_copyright(ci);
}
else {
// No valid communication context – issue error message if necessary
prod_copy_str = 0;
}
4.34.5 Getting product custom string
The operation of getting product custom string belongs to the class of operations called
“Versioning information support requests”. Such an operation is initiated by the device
instance. The CHARON core is defined as a target of the operation. This operation can be
used when CHAPI device need to use product custom string somehow.
In order to perform the operation, the initiator invokes a routine identified by the
get_product_custom_string field of the chapi_in descriptor. The procedure should be invoked
like follows from device instance:
char *prod_cust_str;
…
if(ci && ci->get_product_custom_string) {
prod_cust_str = ci->get_product_custom_string(ci);
}
else {
// No valid communication context – issue error message if necessary
prod_cust_str = 0;
}
4.34.6 Getting product major version number
The operation of getting product major version number belongs to the class of operations
called “Versioning information support requests”. Such an operation is initiated by the
device instance. The CHARON core is defined as a target of the operation. This operation
can be used when CHAPI device need to use product major number somehow, e.g. to
check product version to be greater than something.
In order to perform the operation, the initiator invokes a routine identified by the
get_product_major_version field of the chapi_in descriptor. Procedure invocation example will
be given later.
4.34.7 Getting product minor version number
The operation of getting product minor version number belongs to the class of operations
called “Versioning information support requests”. Such an operation is initiated by the
device instance. The CHARON core is defined as a target of the operation. This operation