1、April 2001Extensions for Financial Services (XFS)interface specification Release 3.0 Part 12: Camera Device Class InterfaceCWA 14050-12Englische Fassung CWA 14050-12:2000ICS 33.160.40; 35.200; 35.240.40Erweiterungen fr die Schnittstellenspezifikation fr Finanzdienst-leistungen (XFS) Version 3.0 Teil
2、 12: Schnittstelle fr die Gerteklasse “Kameras“Nationales VorwortDieses CEN Workshop Agreement CWA 14050-12, das vom CEN/ISSS XFS Workshop erarbeitet wurde,wird ausschlielich in englischer Sprache zur Verfgung gestellt.CEN Workshop Agreements werden im Rahmen eines Konsortiums entwickelt. Sie unters
3、cheiden sich vonEuropischen Normen dadurch, dass sie grundstzlich kein ffentliches Einspruchsverfahren durchlaufenund dass auch keine nationale Meinungsbildung stattfindet. Im Gegensatz zu Europischen Normen, dieden Konsens aller interessierten Kreise darstellen, haben CEN Workshop Agreements ledigl
4、ich dieZustimmung der unmittelbar beteiligten Mitglieder des Konsortiums gefunden.Fr den Inhalt sind ausschlielich die Mitglieder des Konsortiums verantwortlich (siehe ergnzendeHinweise im CWA-Vorwort). Weder das CEN-Zentralsekretariat, noch die CEN-Mitglieder haben den Inhaltauf eventuelle Fehler o
5、der Widersprche zu Normen und Rechtsvorschriften geprft.Fortsetzung 18 Seiten CWA Beuth Verlag GmbH, 2001 .Jede Art der Vervielfltigung, auch auszugsweise, Ref. Nr. DIN CWA 14050-12:2001-04nur mit Genehmigung des Beuth Verlages gestattet. RW DIN CWA Preisgr. 01Alleinverkauf der Normen durch Beuth Ve
6、rlag GmbH, 10772 Berlin Leerseite Rue de Stassart, 36 B-1050 BruxellesTel : +32 2 550 08 11 Fax : +32 2 550 08 19EUROPEAN COMMITTEE FOR STANDARDIZATION COMIT EUROPEN DE NORMALISATION EUROPISCHES KOMITEE FR NORMUNG WORKSHOPCWA 14050-12AGREEMENTNovember 2000ICS 33.160.40; 35.200; 35.240.40Extensions f
7、or Financial Services (XFS) interface specification -Release 3.0 - Part 12: Camera Device Class Interface 2000 CEN All rights of exploitation in any form and by any means reserved world-wide forCEN National MembersRef. No CWA 14050-12:2000 EThis CEN Workshop Agreement can in no way be held as being
8、an official standardas developed by CEN National Members.Page 2CWA 14050-12:2000Table of ContentsForeword 31. Introduction 51.1 Background to Release 3.051.2 XFS Service-Specific Programming52. Banking Cameras.73. References84. Info Commands94.1 WFS_INF_CAM_STATUS94.2 WFS_INF_CAM_CAPABILITIES .115.
9、Execute Commands.135.1 WFS_CMD_CAM_TAKE_PICTURE135.2 WFS_CMD_CAM_RESET146. Events .156.1 WFS_USRE_CAM_MEDIATHRESHOLD156.2 WFS_EXEE_CAM_INVALIDDATA 157. C - Header file .16Page 3CWA 14050-12:2000ForewordThis CWA is revision 3.0 of the XFS interface specification.The move from an XFS 2.0 specification
10、 (CWA 13449) to a 3.0 specification has been prompted by a series offactors.Initially, there has been a technical imperative to extend the scope of the existing specification of the XFSManager to include new devices, such as the Card Embossing Unit.Similarly, there has also been pressure, through im
11、plementation experience and the advance of 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 isnow over 2 years old.
12、 Increasing market acceptance and the need to meet this demand is driving the Workshoptowards this release.The clear direction of the CEN/ISSS XFS Workshop, therefore, is the delivery of a new Release 3.0specification based on a C API. It will be delivered with the promise of the protection of techn
13、ical investment forexisting applications and the design to safeguard future developments.The CEN/ISSS XFS Workshop gathers suppliers as well as banks and other financial service companies. A listof companies participating in this Workshop and in support of this CWA is available from the CEN/ISSSSecr
14、etariat.This CWA was formally approved by the XFS Workshop meeting on 2000-10-18. The specification iscontinuously reviewed and commented in the CEN/ISSS Workshop on XFS. It is therefore expected that anupdate of the specification will be published in due time as a CWA, superseding this revision 3.0
15、.The CWA is published as a multi-part document, 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: Identi
16、fication Card Device Class Interface - Programmers 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
17、 Interface - Programmers ReferencePart 9: 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 Inte
18、rface - Programmers ReferencePart 13: Alarm 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 Inter
19、face (SPI) - Migration from Version2.0 (see 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 (thisCWA) - Programmers ReferencePage 4CWA 14050-12:2000Part 18: Identification Card Device Clas
20、s Interface - Migration from Version 2.0 (see CWA 13449) to Version3.0 (this CWA) - Programmers ReferencePart 19: Cash Dispenser Device Class Interface - Migration from Version 2.0 (see CWA 13449) to Version 3.0(this CWA) - Programmers ReferencePart 20: PIN Keypad Device Class Interface - Migration
21、from Version 2.0 (see CWA 13449) to Version 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 (se
22、e CWA 13449) to Version3.0 (this CWA) - Programmers 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
23、 Version 3.0 (thisCWA) - Programmers ReferencePart 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 conta
24、in clarifications and explanations onthe CWA 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 discus
25、sed as of the dateof publication. It is furnished for informational purposes only and is subject to change without notice.CEN/ISSS makes no warranty, express or implied, with respect to this document.Revision History:1.0 May 24, 1993 Initial release of API and SPI specification1.11 February 3, 1995
26、Separation of specification into separate documents forAPI/SPI and service class definitions2.00 November 11, 1996 Update release encompassing the self-service environment3.00 October 18, 2000 Update release encompassing:- Added WFS_CMD_CAM_RESET- UNICODE supportFor a detailed description see CWA 14
27、050-24CAM migration document from version 2.00 to version3.00, revision 1.00, October 18th2000.Page 5CWA 14050-12:20001. Introduction1.1 Background to Release 3.0The CEN XFS Workshop is a continuation of the Banking Solution Vendors Council workshop and maintains atechnical commitment to the Win 32
28、API. However, the XFS Workshop has extended the franchise of multivendor software by encouraging the participation of both banks and vendors to take part in the deliberations ofthe creation of an industry standard. This move towards opening the participation beyond the BSVCs originalmembership has b
29、een very succesful with a current membership level of more than 20 companies.The fundamental aims of the XFS Workshop are to promote a clear and unambiguous specification for bothservice providers and application developers. This has been achieved to date by sub groups workingelectronically and quar
30、terly meetings.The move from an XFS 2.0 specification to a 3.0 specification has been prompted by a series of factors. Initially,there has been a technical imperative to extend the scope of the existing specification of the XFS Manager toinclude new devices, such as the Card Embossing Unit.Similarly
31、, there has also been pressure, through implementation experience and the advance of 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 sp
32、ecification, which isnow over 2 years old. Increasing market acceptance and the need to meet this demand is driving the Workshoptowards this release.The clear direction of the XFS Workshop, therefore, is the delivery of a new Release 3.0 specification based ona C API. It will be delivered with the p
33、romise of the protection of technical investment for existing applicationsand the design to safeguard future developments.1.2 XFS Service-Specific ProgrammingThe service classes are defined by their service-specific commands and the associated data structures, errorcodes, messages, etc. These comman
34、ds are used to request functions that are specific to one or more classes ofservice providers, but not all of them, and therefore are not included in the common API for basic oradministration functions.When a service-specific command is common among two or more classes of service providers, the synt
35、ax of thecommand is as similar as possible across all services, since a major objective of the Extensions for FinancialServices is to standardize command codes and structures for the broadest variety of services. For example, usingthe WFSExecute function, the commands to read data from various servi
36、ces are as similar as possible to eachother in their syntax and data structures.In general, the specific command set for a service class is defined as the union of the specific capabilities likelyto be provided by the developers of the services of that class; thus any particular device will normally
37、 supportonly a subset of the defined command set.Page 6CWA 14050-12:2000There are three cases in which a service provider may receive a service-specific command that it does notsupport:The requested capability is defined for the class of service providers by the XFS specification, the particularvend
38、or implementation of that service does not support it, and the unsupported capability is not consideredto be fundamental to the service. In this case, the service provider returns a successful completion, but doesno operation. An example would be a request from an application to turn on a control in
39、dicator on apassbook printer; the service provider recognizes the command, but since the passbook printer it ismanaging does not include that indicator, the service provider does no operation and returns a successfulcompletion to the application.The requested capability is defined for the class of s
40、ervice providers by the XFS specification, the particularvendor implementation of that service does not support it, and the unsupported capability is considered to befundamental to the service. In this case, a WFS_UNSUPP_COMMAND error is returned to the callingapplication. An example would be a requ
41、est from an application to a cash dispenser to dispense coins; theservice provider recognizes the command but, since the cash dispenser it is managing dispenses only notes,returns this error.The requested capability is not defined for the class of service providers by the XFS specification. In thisc
42、ase, a WFS_ERR_INVALID_COMMAND error is returned to the calling application.This design allows implementation of applications that can be used with a range of services that providediffering subsets of the functionalities that are defined for their service class. Applications may use theWFSGetInfo an
43、d WFSAsyncGetInfo commands to inquire about the capabilities of the service they are aboutto use, and modify their behavior accordingly, or they may use functions and then deal withWFS_ERR_UNSUPP_COMMAND error returns to make decisions as to how to use the service.Page 7CWA 14050-12:20002. Banking C
44、amerasThis specification describes the functionality of the services provided by the Camera (CAM) services underXFS, by defining the service-specific commands that can be issued, using the WFSGetInfo,WFSAsyncGetInfo, WFSExecute and WFSAsyncExecute functions.Banking camera systems usually consist of
45、a recorder, a video mixer and one or more cameras. If there areseveral cameras, each camera focuses a special place within the self-service area (eg. the room, the customer orthe cash tray). By using the video mixer it can be decided, which of the cameras should take the next photo.Furthermore data
46、can be given to be inserted in the photo (eg. date, time or bankcode).If there is only one camera that can switch to take photos from different positions, it is presented by the serviceprovider as a set of cameras, one for each of its possible positions.Page 8CWA 14050-12:20003. References1. XFS App
47、lication Programming Interface (API)/Service Provider Interface ( SPI), Programmers ReferenceRevision 3.00, October 18, 2000Page 9CWA 14050-12:20004. Info Commands4.1 WFS_INF_CAM_STATUSDescription This command reports the full range of information available, including the information that isprovided
48、 by the service provider.Input Param None.Output Param LPWFSCAMSTATUS lpStatus;typedef struct _wfs_cam_statusWORD fwDevice;WORD fwMediaWFS_CAM_CAMERAS_SIZE;WORD fwCamerasWFS_CAM_CAMERAS_SIZE;USHORT usPicturesWFS_CAM_CAMERAS_SIZE;LPSTR lpszExtra; WFSCAMSTATUS, * LPWFSCAMSTATUS;fwDeviceSpecifies the s
49、tate of the Camera device as one of the following flags:Value MeaningWFS_CAM_DEVONLINE The device is online (i.e., powered on and operable).WFS_CAM_DEVOFFLINE The device is offline (e.g., the operator has taken thedevice offline by turning a switch or pulling out thedevice).WFS_CAM_DEVPOWEROFF The device is powered off or physically notconnected.WFS_CAM_DEVNODEVICE There is no device intended to be there; e.g. this typeof self service machine does not contain such a deviceor it is internally not configured.WFS_CAM_DEVHWERRO
