Compsee Apex III, Technical Reference Manual

Page: 87 / 168

Apex PDT Technical Reference Manual 6 Utility Programs
COAM30002 Rev. 2.00 8/13/02
6-15
BcApiRegisterBuffer continued
Returns:
0 for success, non-zero on failure.
Notes:
This function is used to register an external buffer,
supplied by the application, with the driver. If the pointer
to
buf is not NULL, the driver will place the decoded
ASCIIZ characters into the array, and fill in the
decodedCount and symbology values as well. If the value
passed for buf is NULL, the driver will return to wedge
operation, whereby it stuffs the keyboard buffer with the
decoded characters. An application program that registers
an external buffer, MUST release the buffer when exiting
to DOS.
Release Buffer
BcApiReleaseBuffer
Syntax:
void BcApiReleaseBuffer(void)
Input:
None
Returns:
None
Notes:
The BcApiReleaseBuffer function calls
BcApiRegisterBuffer() with a NULL argument for the
buffer address (defaults the ID to BCD_ID - 0CEh). If an
application has changed the default multiplex ID for the
driver, this call will fail. In this event, call
BcApiRegisterBuffer() which will supply the correct
argument for id and NULL for the buffer pointer.
Get Key
Getkey
Syntax:
int Getkey(void)
Input:
Available keystrokes from the keyboard buffer
Returns:
If an extended scan code is found, it returns the scan code
+ 100h to easily differentiate extended keys from ASCII.
Notes:
The Getkey function gets the next available keystroke from
the keyboard buffer using getch(). The <SCAN> key is
returned as 138h. Using getch() causes this function to
wait for the next available keystroke.