Setsecurepindisplayparameters() - VeriFone MX800 series Programmer's Manual

SetSecurePINDisplayParameters()

setSecurePINDisplayParameters() sets the hot spot table and registers
the callback function for the upcoming PIN session. This function must be called
each time prior to requesting a PIN session either through an IPP packet (Z60,
Z63 or Z69) or through a VeriShield Security Script API
(iPS_RequestPINEntry()).
Prototype
void setSecurePINDisplayParameters(struct touch_hs_s *hotspot_table, void
*callback);
The touch_hs_s structure is as follows:
struct touch_hotspot_info
{
unsigned short x1; /* starting x of hotspot */
unsigned short y1; /* starting y of hotspot */
unsigned short x2; /* ending x of hotspot */
unsigned short y2; /* ending y of hotspot */
char result; /* ASCII value to return */
charoptions; /* RESERVED */
};
The purpose of the hotspot table is to define active display regions. A rectangular
region is defined by two points using display pixel coordinates.
The first point is the upper left corner and the second point is the lower right
corner of the active region.
The values for x are 0 to 319 and 0 to 233 for y.
For example, if x1=0, y1=0 and x2=49, y2=49, then the hotspot region is 50 pixels
in both height and width with the top left corner positioned on the display at pixel
location (0,0).
The value defined in result is the ASCII value that is returned when the hotspot is
activated.
D
SetSecurePINDisplayParameters()
X
M 800 S P
ERIES ROGRAMMERS
D
EVICE RIVERS
51
G
UIDE