1、April 2001Extensions for Financial Services (XFS) interface specification Release 3.0 Part 17: Printer Device Class Interface Migration from Version 2.0 (see CWA 13449) to Version 3.0(this CWA) Programmers ReferenceCWA 14050-17Englische Fassung CWA 14050-17:2000ICS 35.200; 35.240.40Erweiterungen fr
2、die Schnittstellenspezifikation fr Finanzdienst-leistungen (XFS) Version 3.0 Teil 17: Schnittstelle fr die Gerteklasse “Drucker“ Migration vonVersion 2.0 (siehe CWA 13449) zu Version 3.0 (dieses CWA) ProgrammierhandbuchNationales VorwortDieses CEN Workshop Agreement CWA 14050-17, das vom CEN/ISSS XF
3、S Workshop erarbeitet wurde,wird ausschlielich in englischer Sprache zur Verfgung gestellt.CEN Workshop Agreements werden im Rahmen eines Konsortiums entwickelt. Sie unterscheiden sich vonEuropischen Normen dadurch, dass sie grundstzlich kein ffentliches Einspruchsverfahren durchlaufenund dass auch
4、keine nationale Meinungsbildung stattfindet. Im Gegensatz zu Europischen Normen, dieden Konsens aller interessierten Kreise darstellen, haben CEN Workshop Agreements lediglich dieZustimmung der unmittelbar beteiligten Mitglieder des Konsortiums gefunden.Fr den Inhalt sind ausschlielich die Mitgliede
5、r des Konsortiums verantwortlich (siehe ergnzendeHinweise im CWA-Vorwort). Weder das CEN-Zentralsekretariat, noch die CEN-Mitglieder haben den Inhaltauf eventuelle Fehler oder Widersprche zu Normen und Rechtsvorschriften geprft.Fortsetzung 61 Seiten CWA Beuth Verlag GmbH, 2001 .Jede Art der Vervielf
6、ltigung, auch auszugsweise, Ref. Nr. DIN CWA 14050-17:2001-04nur mit Genehmigung des Beuth Verlages gestattet. RW DIN CWA Preisgr. 08Alleinverkauf der Normen durch Beuth Verlag GmbH, 10772 Berlin Leerseite Rue de Stassart, 36 B-1050 BruxellesTel : +32 2 550 08 11 Fax : +32 2 550 08 19EUROPEAN COMMIT
7、TEE FOR STANDARDIZATION COMIT EUROPEN DE NORMALISATION EUROPISCHES KOMITEE FR NORMUNG WORKSHOPCWA 14050-17AGREEMENTNovember 2000ICS 35.200; 35.240.40Extensions for Financial Services (XFS) interface specification -Release 3.0 - Part 17: Printer Device Class Interface - Migration fromVersion 2.0 (see
8、 CWA 13449) to Version 3.0 (this CWA) - ProgrammersReference 2000 CEN All rights of exploitation in any form and by any means reserved world-wide forCEN National MembersRef. No CWA 14050-17:2000 EThis CEN Workshop Agreement can in no way be held as being an official standardas developed by CEN Natio
9、nal Members.Page 2CWA 14050-17:2000Table of ContentsForeword41. General.62. New Chapters 62.1. References 62.2. XFS form/media definition files in multi-vendor environments 63. New Info Commands.64. Changes to Existing Info Commands74.1. WFS_INF_PTR_STATUS 74.2. WFS_INF_PTR_CAPABILITIES . 104.3. WFS
10、_INF_PTR_QUERY_FORM 134.4. WFS_INF_PTR_QUERY_MEDIA 154.5. WFS_INF_PTR_QUERY_FIELD. 175. New Execute Commands195.1. WFS_CMD_PTR_RESET .195.2. WFS_CMD_PTR_RETRACT_MEDIA. 205.3. WFS_CMD_PTR_DISPENSE_PAPER . 216. Changes to existing Execute Commands.216.1. WFS_CMD_PTR_CONTROL_MEDIA 216.2. WFS_CMD_PTR_PR
11、INT_FORM 246.3. WFS_CMD_PTR_READ_FORM. 276.4. WFS_CMD_PTR_RAW_DATA. 296.5. WFS_CMD_PTR_MEDIA_EXTENTS . 306.6. WFS_CMD_PTR_RESET_COUNT. 316.7. WFS_CMD_PTR_READ_IMAGE 327. New Events 347.1. WFS_USRE_PTR_LAMPTHRESHOLD . 347.2. WFS_USRE_PTR_INKTHRESHOLD . 347.3. WFS_SRVE_PTR_MEDIADETECTED. 358. Changes
12、to existing Events .358.1. WFS_EXEE_PTR_FIELDERROR. 358.2. WFS_USRE_PTR_RETRACTBINTHRESHOLD 368.3. WFS_USRE_PTR_PAPERTHRESHOLD. 369. Changes to Form, Sub-Form, Field and Media Definitions37Page 3CWA 14050-17:20009.1. Definition Syntax 379.2. Form and Media Measurements. 389.3. Form Definition 389.4.
13、 SubForm Definition 409.5. Field Definition 419.6. Frame Definition. 469.7. Media Definition . 5210. Changes to C-Header file.53Page 4CWA 14050-17:2000ForewordThis CWA is revision 3.0 of the XFS interface specification.The move from an XFS 2.0 specification (CWA 13449) to a 3.0 specification has bee
14、n prompted by a series offactors.Initially, there has been a technical imperative to extend the scope of the existing specification of the XFS Managerto include new devices, such as the Card Embossing Unit.Similarly, there has also been pressure, through implementation experience and the advance of
15、the Microsofttechnology, to extend the functionality and capabilities of the existing devices covered by the specification.Finally, it is also clear that our customers and the market are asking for an update to a specification, which is nowover 2 years old. Increasing market acceptance and the need
16、to meet this demand is driving the Workshop towardsthis release.The clear direction of the CEN/ISSS XFS Workshop, therefore, is the delivery of a new Release 3.0 specificationbased on a C API. It will be delivered with the promise of the protection of technical investment for existingapplications an
17、d the design to safeguard future developments.The CEN/ISSS XFS Workshop gathers suppliers as well as banks and other financial service companies. A list ofcompanies participating in this Workshop and in support of this CWA is available from the CEN/ISSS Secretariat.This CWA was formally approved by
18、the XFS Workshop meeting on 2000-10-18. The specification is continuouslyreviewed and commented in the CEN/ISSS Workshop on XFS. It is therefore expected that an update of thespecification will be published in due time as a CWA, superseding this revision 3.0.The CWA is published as a multi-part docu
19、ment, consisting of:Part 1: Application Programming Interface (API) - Service Provider Interface (SPI); Programmers ReferencePart 2: Service Classes Definition; Programmers ReferencePart 3: Printer Device Class Interface - Programmers ReferencePart 4: Identification Card Device Class Interface - Pro
20、grammers ReferencePart 5: Cash Dispenser Device Class Interface - Programmers ReferencePart 6: PIN Keypad Device Class Interface - Programmers ReferencePart 7: Check Reader/Scanner Device Class Interface - Programmers ReferencePart 8: Depository Device Class Interface - Programmers ReferencePart 9:
21、Text Terminal Unit Device Class Interface - Programmers ReferencePart 10: Sensors and Indicators Unit Device Class Interface - Programmers ReferencePart 11: Vendor Dependent Mode Device Class Interface - Programmers ReferencePart 12: Camera Device Class Interface - Programmers ReferencePart 13: Alar
22、m Device Class Interface - Programmers ReferencePart 14: Card Embossing Unit Class Interface - Programmers ReferencePart 15: Cash In Module Device Class Interface- Programmers ReferencePart 16: Application Programming Interface (API) - Service Provider Interface (SPI) - Migration from Version 2.0(se
23、e CWA 13449) to Version 3.0 (this CWA) - Programmers ReferencePart 17: Printer Device Class Interface - Migration from Version 2.0 (see CWA 13449) to Version 3.0 (this CWA) -Programmers ReferencePart 18: Identification Card Device Class Interface - Migration from Version 2.0 (see CWA 13449) to Versi
24、on 3.0(this CWA) - Programmers ReferencePage 5CWA 14050-17:2000Part 19: Cash Dispenser Device Class Interface - Migration from Version 2.0 (see CWA 13449) to Version 3.0 (thisCWA) - Programmers ReferencePart 20: PIN Keypad Device Class Interface - Migration from Version 2.0 (see CWA 13449) to Versio
25、n 3.0 (thisCWA) - Programmers ReferencePart 21: Depository Device Class Interface - Migration from Version 2.0 (see CWA 13449) to Version 3.0 (thisCWA) - Programmers ReferencePart 22: Text Terminal Unit Device Class Interface - Migration from Version 2.0 (see CWA 13449) to Version 3.0(this CWA) - Pr
26、ogrammers ReferencePart 23: Sensors and Indicators Unit Device Class Interface - Migration from Version 2.0 (see CWA 13449) toVersion 3.0 (this CWA) - Programmers ReferencePart 24: Camera Device Class Interface - Migration from Version 2.0 (see CWA 13449) to Version 3.0 (this CWA)- Programmers Refer
27、encePart 25: Identification Card Device Class Interface - PC/SC Integration GuidelinesIn addition to these Programmers Reference specifications, the reader of this CWA is also referred to acomplementary document, called Release Notes. The Release Notes contain clarifications and explanations on theC
28、WA specifications, which are not requiring functional changes. The current version of the Release Notes isavailable online from http:/www.cenorm.be/isss/Workshop/XFS.The information in this document represents the Workshops current views on the issues discussed as of the date ofpublication. It is fu
29、rnished for informational purposes only and is subject to change without notice. CEN/ISSSmakes no warranty, express or implied, with respect to this document.Page 6CWA 14050-17:20001. GeneralA new type scanner, multiple supplies, multiple retract bins and UNICODE support for FieldValues have beenadd
30、ed. In addition to that the command for scanning images has also been improved.2. New Chapters2.1. References1. XFS Application Programming Interface (API)/Service Provider Interface ( SPI), Programmers ReferenceRevision 3.00, October 18, 20002.2. XFS form/media definition files in multi-vendor envi
31、ronmentsAlthough for most Service Providers directory location and extension of XFS form/media definition files areconfigurable through the registry, the capabilities of Service Providers and or actual hardware may vary. Thereforethe following considerations should be taken into account when applica
32、tions use XFS form definition files with thepurpose of running in a multi-vendor environment:- Physical print area dimensions of printers are not identical- Graphic printout may not be supported, which may limit the use of the FONT, CPI and LPI keywords- Some printers may have a resolution of dots/m
33、m rather than dots/inch, which may result in printouts with aspecific CPI/LPI font resolution to be slightly off size- Just-in-time form loading may not be supported by all Service Providers, which makes it impossible to createdynamic form files just before printing (which in return means that only
34、the print data of the forms can bechanged, not the -layout data such as the font and font size)- Some form/media definition keywords may not be supported due to limitations of the hardware or software3. New Info CommandsThere are no new Info Commands.Page 7CWA 14050-17:20004. Changes to Existing Inf
35、o Commands4.1. WFS_INF_PTR_STATUSDescription This command is used to request status information for the device.Input Param None.Output Param LPWFSPTRSTATUS lpStatus;typedef struct _wfs_ptr_statusWORD fwDevice;WORD fwMedia;WORD fwPaperWFS_PTR_SUPPLYSIZE;WORD fwToner;WORD fwInk;WORD fwLamp;WORD fwRetr
36、actBin;WORD usRetractCount;LPWFSPTRRETRACTBINS * lppRetractBins;USHORT usMediaOnStacker;LPSTR lpszExtra; WFSPTRSTATUS, * LPWFSPTRSTATUS;fwDeviceSpecifies the state of the print device as one of the following flags:Value MeaningWFS_PTR_DEVONLINE The device is online (i.e. powered on and operable).WFS
37、_PTR_DEVOFFLINE The device is offline (e.g., the operator has taken thedevice offline by turning a switch or pulling out thedevice).WFS_PTR_DEVPOWEROFF The device is powered off or physically not connected.WFS_PTR_DEVNODEVICE There is no device intended to be there; e.g. this type ofself service mac
38、hine does not contain such a device or itis internally not configured.WFS_PTR_DEVHWERROR The device is inoperable due to a hardware error.WFS_PTR_DEVUSERERROR The device is present but a person is preventing properdevice operation. The application should suspend thedevice from service until the serv
39、ice provider generates adevice state change event indicating the condition of thedevice has changed, e.g., the error is removed(WFS_PTR_DEVONLINE) or a permanent errorcondition has occurred (WFS_PTR_DEVHWERROR).WFS_PTR_DEVBUSY The device is busy and unable to process an executecommand at this time.f
40、wMediaSpecifies the state of the print media (i.e. receipt, statement, passbook, etc) as one of thefollowing values:Value MeaningWFS_PTR_MEDIAPRESENT Media is in the print position or on the stacker (i.e. apassbook in the parking position is not considered to bepresent).WFS_PTR_MEDIANOTPRESENT Media
41、 is not in the print position or on the stacker.WFS_PTR_MEDIAJAMMED Media is jammed in the device.WFS_PTR_MEDIANOTSUPP The capability to report the state of the print media is notsupported by the device.WFS_PTR_MEDIAUNKNOWN The state of the print media cannot be determined withthe device in its curr
42、ent state.WFS_PTR_MEDIAENTERING Media is at the entry/exit slot of the device.Page 8CWA 14050-17:2000fwPaperSpecifies the state of the paper supplies. A number of paper supplies are defined below. Vendorspecific paper supplies are defined starting from the end od the array. The maximum paperindex is
43、 WFS_PTR_SUPPLYMAXfwPaperWFS_PTR_SUPPLYUPPERSpecifies the state of the only paper supply or the upper paper supply, if more than one, as oneof the following values:Value MeaningWFS_PTR_PAPERFULL The paper supply is full.WFS_PTR_PAPERLOW The paper supply is low.WFS_PTR_PAPEROUT The paper supply is em
44、pty.WFS_PTR_PAPERNOTSUPP Capability not supported by device.WFS_PTR_PAPERUNKNOWN Capability cannot be determined with device in its currentstate.fwPaperWFS_PTR_SUPPLYLOWERSpecifies the state of the lower paper supply as one of the following values:Value MeaningWFS_PTR_PAPERFULL The paper supply is f
45、ull.WFS_PTR_PAPERLOW The paper supply is low.WFS_PTR_PAPEROUT The paper supply is empty.WFS_PTR_PAPERNOTSUPP Capability not supported by device.WFS_PTR_PAPERUNKNOWN Capability cannot be determined with device in its currentstate.fwPaperWFS_PTR_SUPPLYEXTERNALSpecifies the state of the external paper
46、supply as one of the following values:Value MeaningWFS_PTR_PAPERFULL The paper supply is full.WFS_PTR_PAPERLOW The paper supply is low.WFS_PTR_PAPEROUT The paper supply is empty.WFS_PTR_PAPERNOTSUPP Capability not supported by device.WFS_PTR_PAPERUNKNOWN Capability cannot be determined with device i
47、n its currentstate.fwPaperWFS_PTR_SUPPLYAUXSpecifies the state of the auxiliary paper supply as one of the following values:Value MeaningWFS_PTR_PAPERFULL The paper supply is full.WFS_PTR_PAPERLOW The paper supply is low.WFS_PTR_PAPEROUT The paper supply is empty.WFS_PTR_PAPERNOTSUPP Capability not
48、supported by device.WFS_PTR_PAPERUNKNOWN Capability cannot be determined with device in its currentstate.fwPaperWFS_PTR_SUPPLYAUX2Specifies the state of the second auxiliary paper supply as one of the following values:Value MeaningWFS_PTR_PAPERFULL The paper supply is full.WFS_PTR_PAPERLOW The paper
49、 supply is low.WFS_PTR_PAPEROUT The paper supply is empty.WFS_PTR_PAPERNOTSUPP Capability not supported by device.WFS_PTR_PAPERUNKNOWN Capability cannot be determined with device in its currentstate.fwPaperWFS_PTR_SUPPLYPARKSpecifies the state of the parking station as one of the following values:Value MeaningWFS_PTR_PAPERFULL The parking station is busy.WFS_PTR_PAPEROUT The parking station is free.WFS_PTR_PAPERNOTSUPP Capability not supported by device.Page 9CWA 14050-17:2000WFS_PTR_
