eDecode[in]Identifies the decoding for Interleaved 2 of 5
symbology.
eCheck[in]Identifies the check digit.
eLengthId[in]Use
ITC_BARCODE_LENGTH_NO_CHANGE to
indicate no change for bar code length. Use
ITC_BARCODE_LENGTH for any length and
minimum length, and set rgbLengthBuff[0] to a
valid length value. Use
ITC_BARCODE_FIXED_LENGTH to compose
1 or 2 or 3 fixed lengths, and set 3 bytes:
rgbLengthBuff[0], rgbLengthBuff[1],
rgbLengthBuff[2] with valid values.
rgbLengthBuff[in,size_is(dwNumBytes)]
Contains bar code lengths when eLengthId =
Use ITC_BARCODE_LENGTH or
Use ITC_BARCODE_FIXED_LENGTH.
dwNumBytes[in] Number of bytes in rbgLengthBuff[]. For S9C, this
value is 1 when eLengthId =
ITC_BARCODE_LENGTH or 3 when eLengthId
= ITC_BARCODE_FIXED_LENGTH.
eDecode[in]Identifies the decoding for Matrix 2 of 5 symbology.
dwLength[in] Identifies the bar code length.
Return Values
HRESULT that indicates success or failure.
Remarks
None.
See Also
None.
Matrix 2 of 5 Default Settings
ParameterDefaultValid Range
DecodingNot ActiveITC_MATRIX2OF5_DECODING
Bar Code LengthMinimum Length = 60x00`0xFEITC_BC_LENGTH_NO_CHANGE
Matrix 2 of 5 Enumerations
typedef enum tagMatrix2of5Decoding
{
ITC_MATRIX2OF5_NOTACTIVE = 0, // Default
ITC_MATRIX2OF5_ACTIVE = 1,
ITC_MATRIX2OF5_NO_CHANGE = 255
} ITC_MATRIX2OF5_DECODING;
#define ITC_BC_LENGTH_NO_CHANGE 255. This definition can be used when the bar
code length does not require any change.
eDecode[in]Identifies the decoding for MSI symbology.
eCheck[in] Identifies the check digit.
dwLength[in] Identifies the bar code length.
Return Values
HRESULT that indicates success or failure.
Remarks
None.
See Also
None.
MSI Default Settings
ParameterDefaultValid Range
DecodingNot ActiveITC_MSI_DECODING
Check DigitMOD 10 checked and transmittedITC_MSI_CHECK_DIGIT
Bar Code LengthMinimum Length = 60x00`0xFEITC_BC_LENGTH_NO_CHANGE
187700 Series Color Mobile Computer User’s Manual
Scanner SupportChapter—6
MSI Enumerations
typedef enum tagMsiDecoding
{
ITC_MSI_NOTACTIVE = 0, // Default
ITC_MSI_ACTIVE = 1,
ITC_MSI_NO_CHANGE = 255
} ITC_MSI_DECODING;
typedef enum tagMsiCheckDigit
{
ITC_MSI_CHECK_MOD10_XMIT, // Default
ITC_MSI_CHECK_MOD10_NOTXMIT,
ITC_MSI_CHECK_DOUBLEMOD10_XMIT,
ITC_MSI_CHECK_DOUBLEMOD10_NOTXMIT,
ITC_MSI_CHECK_NO_CHANGE = 255
} ITC_MSI_CHECK_DIGIT;
#define ITC_BC_LENGTH_NO_CHANGE 255. This definition can be used when the bar
code length does not require any change.
IS9CConfig::GetPDF417
This function retrieves the current PDF417 settings.
eDecode[in]Identifies the decoding for Plessey symbology.
eCheck[in]Identifies the check digit.
dwLength[in] Identifies the bar code length.
Return Values
HRESULT that indicates success or failure.
Remarks
None.
See Also
None.
192700 Series Color Mobile Computer User’s Manual
6Scanner Support—Chapter
Plessey Default Settings
ParameterDefaultValid Range
DecodingNot ActiveITC_PLESSEY_DECODING
Check DigitNot TransmittedITC_PLESSEY_CHECK_DIGIT
Bar Code LengthAny Bar Code Length0x00`0xFEITC_BC_LENGTH_NO_CHANGE
Plessey Enumerations
typedef enum tagPlesseyDecoding
{
ITC_PLESSEY_NOTACTIVE = 0,// Default
ITC_PLESSEY_ACTIVE = 1,
ITC_PLESSEY_NO_CHANGE = 255
} ITC_PLESSEY_DECODING;
typedef enum tagPlesseyCheckDigit
{
ITC_PLESSEY_CHECK_NOTXMIT = 0,// Default
ITC_PLESSEY_CHECK_XMIT = 1,
ITC_PLESSEY_CHECK_NO_CHANGE = 255
} ITC_PLESSEY_CHECK_DIGIT;
#define ITC_BC_LENGTH_NO_CHANGE 255. This definition can be used when the bar
code length does not require any change.
193700 Series Color Mobile Computer User’s Manual
Scanner SupportChapter—6
IS9CConfig::GetStandard2of5
This function retrieves the current Standard 2 of 5 settings.
eDecode[in]Identifies the decoding for Standard 2 of 5
symbology.
eFormat[in] Identifies the format.
eCheck[in] Identifies the Modulo 10 check digit.
eLengthId[in] Use
ITC_BARCODE_LENGTH_NO_CHANGE to
indicate no change for bar code length. Use
ITC_BARCODE_LENGTH for any length and
minimum length, and set rgbLengthBuff[0] to a
valid length value. Use
ITC_BARCODE_FIXED_LENGTH to compose
1 or 2 or 3 fixed lengths, and set 3 bytes:
rgbLengthBuff[0], rgbLengthBuff[1],
rgbLengthBuff[2] with valid values.
rgbLengthBuff[in,size_is(dwNumBytes)]
An array of bytes containing bar code lengths when
eLengthId = ITC_BARCODE_LENGTH or
ITC_BARCODE_FIXED_LENGTH.
dwNumBytes[in] Number of bytes in rbgLengthBuff[]. For S9C, this
value is 1 when eLengthId =
ITC_BARCODE_LENGTH or 3 when eLengthId
= ITC_BARCODE_FIXED_LENGTH.
This interface is derived from the IS9CConfig interface and provides additional methods that can be used to set and retrieve the 700 Series Computer’ s bar code configuration. All supported symbologies are initialized to
their defaults when the S9C firmware is loaded.
GET/SET functions use enumerations as their parameters. In most enumerations, there is an enumerator xx_NO_CHANGE (such as
ITC_CODE39_NO_CHANGE), where xx refers to a particular enumeration. This enumerator can be used during a call to a SET to indicate
that no change is to be made to that particular parameter. This prevents
the called function from having to format the same S9C command and
send it down to the scanner.
To specify a bar code length of “any length,” use a value of “0” for the bar
code length argument.
IS9CConfig2 functions are the following. IS9CCONFIG.H is the header
file and ITCUUID.LIB contains the IID_IADC Interface GUID value
used to obtain the interface.
S IS9CConfig2::GetCode11 (page 205)
S IS9CConfig2::SetCode11 (page 205)
S IS9CConfig2::GetCustomSymIds (page 207)
S IS9CConfig2::SetCustomSymIds (page 208)
S IS9CConfig2::GetGlobalAmble (page 211)
S IS9CConfig2::SetGlobalAmble (page 212)
S IS9CConfig2::GetPDF417Ext (page 213)
S IS9CConfig2::SetPDF417Ext (page 213)
S IS9CConfig2::GetSymIdXmit (page 214)
S IS9CConfig2::SetSymIdXmit (page 214)
204700 Series Color Mobile Computer User’s Manual
6Scanner Support—Chapter
IS9CConfig2::GetCode11
This function retrieves the current settings for Code 11.
This function retrieves all the custom symbology identifiers defined for the
currently supported symbologies. This is not supported when using an imag-
pStructSymIdPair[out]Pointer to ITC_CUST_SYM_ID_PAIR
location to receive the current defined
symbology identifiers for the supported
symbologies. The caller must preallocate
this buffer with dwMaxNumElement
elements.
dwMaxNumElement[in]Maximum number of elements allocated
for the pStructSymIdPair buffer which
should always be equal to the last defined
enumeration constant + 1 of the
enumeration ITC_CUSTOM_ID. In this
case, it is
ITC_CUSTOMID_LAST_ELEMENT.
pdwNumElement[out]Pointer to DWORD location to receive
the actual number of elements returned in
the pStructSymIdPair buffer, which should
be the same as dwMaxNumElement.
Return Values
HRESULT that indicates success or failure.
Remarks
None.
See Also
S Custom Identifier Assignments (page 209)
S Custom Identifier Example (page 210)
S Custom Identifier Default Settings (page 210)
207700 Series Color Mobile Computer User’s Manual
Scanner SupportChapter—6
IS9CConfig2::SetCustomSymIds
This function updates the symbology identifiers (any ASCII values) for the
currently supported symbologies. This is not supported when using an imag-
pStructSymIdPair[in]Pointer to ITC_CUST_SYM_ID_PAIR
location, containing the new symbology
identifiers for any supported symbologies to
update.
dwNumElement[in]Identifies the number of symbology identifiers
to update in the pStructSymIdPair buffer.
Return Values
HRESULT that indicates success or failure.
Remarks
None.
See Also
None.
208700 Series Color Mobile Computer User’s Manual
6Scanner Support—Chapter
Custom Identifier Assignments
Each custom identifier is a one byte ASCII value within the range from
0x00 to 0xff. The enumerations in the ITC_CUSTOM_ID enumerator
can be used as symbology identifications in the GetCustomSymIds() and
SetCustomSymIds() functions.
typedef enum tagCustomId
{
ITC_CUSTOMID_CODABAR = 0Identifies the Codabar symbology
ITC_CUSTOMID_CODE39Identifies the Code 39 symbology
ITC_CUSTOMID_CODE93Identifies the Code 93 symbology
ITC_CUSTOMID_CODE128_EAN_128Identifies the Code 128 symbology
ITC_CUSTOMID_EAN8Identifies the EAN-8 symbology
ITC_CUSTOMID_EAN13Identifies the EAN-13 symbology
ITC_CUSTOMID_I2OF5Identifies the Interleaved 2 of 5 symbology
ITC_CUSTOMID_MATRIX2OF5Identifies the Matrix 2 of 5 symbology
ITC_CUSTOMID_MSIIdentifies the MSI symbology
ITC_CUSTOMID_PDF417Identifies the PDF 417 symbology
ITC_CUSTOMID_PLESSEYIdentifies the Plessey symbology
ITC_CUSTOMID_CODE2OF5Identifies the Standard 2 of 5 symbology
ITC_CUSTOMID_TELEPENIdentifies the Telepen symbology
ITC_CUSTOMID_UPCAIdentifies the UPC-A symbology
ITC_CUSTOMID_UPCEIdentifies the UPC-E symbology
ITC_CUSTOMID_CODE11Identifies the Code 11 symbology
ITC_CUSTOMID_LAST_ELEMENTIdentifies the last element. Use to preallocate
the buffer on GetCustomSymIds
}ITC_CUSTOM_ID;
typedef struct tagCustSymbIdPair
{
ITC_CUSTOM_ID eSymbology;Identifies the symbology of interest
BYTE byteId;
ASCII value (1 byte within the range0x00 – 0xf)
}ITC_CUST_SYM_ID_PAIR;
209700 Series Color Mobile Computer User’s Manual
Scanner SupportChapter—6
Custom Identifier Default Settings
SymbologyDefaultValid Range
CodabarD0x00-0xFF
Code 11*0x00-0xFF
Code 39*0x00-0xFF
Code 93D0x00-0xFF
Code128/EAN 128D0x00-0xFF
EAN-80xFF0x00-0xFF
EAN-13F0x00-0xFF
Interleaved 2 of 5I0x00-0xFF
Matrix 2 of 5D0x00-0xFF
MSID0x00-0xFF
PDF 417*0x00-0xFF
PlesseyD0x00-0xFF
Standard 2 of 5D0x00-0xFF
Tel e p e n*0x00-0xFF
UPC-AA0x00-0xFF
UPC-EE0x00-0xFF
Custom Identifier Example
The following code segment is an example of updating the UPC-E and
UPC-A symbology identifiers with new values, and then retrieving the
currently defined symbology identifiers for all the supported symbologies: