ANSI INCITS ISO IEC 19784-2-2007 Information technology - Biometric application programming interface - Part 2 Biometric archive function provider interface《信息技术.生物统计应用程序设计接口.第2部分 .pdf

《ANSI INCITS ISO IEC 19784-2-2007 Information technology - Biometric application programming interface - Part 2 Biometric archive function provider interface《信息技术.生物统计应用程序设计接口.第2部分 .pdf》由会员分享，可在线阅读，更多相关《ANSI INCITS ISO IEC 19784-2-2007 Information technology - Biometric application programming interface - Part 2 Biometric archive function provider interface《信息技术.生物统计应用程序设计接口.第2部分 .pdf（32页珍藏版）》请在麦多课文档分享上搜索。

1、INCITS/ISO/IEC 19784-2-20072008(ISO/IEC 19784-2-2007, IDT) Information technology Biometricapplication programming interface Part 2: Biometric archive function provider interfaceINCITS/ISO/IEC 19784-2-20072008 (ISO/IEC 19784-2-2007, IDT)Copyright American National Standards Institute Provided by IHS

2、 under license with ANSI Not for ResaleNo reproduction or networking permitted without license from IHS-,-,-INCITS/ISO/IEC 19784-2-20072008 ii ITIC 2008 All rights reserved PDF disclaimer This PDF file may contain embedded typefaces. In accordance with Adobes licensing policy, this file may be print

3、ed or viewed but shall not be edited unless the typefaces which are embedded are licensed to and installed on the computer performing the editing. In downloading this file, parties accept therein the responsibility of not infringing Adobes licensing policy. The ISO Central Secretariat accepts no lia

4、bility in this area. Adobe is a trademark of Adobe Systems Incorporated. Details of the software products used to create this PDF file can be found in the General Info relative to the file; the PDF-creation parameters were optimized for printing. Every care has been taken to ensure that the file is

5、suitable for use by ISO member bodies. In the unlikely event that a problem relating to it is found, please inform the Central Secretariat at the address given below. Adopted by INCITS (InterNational Committee for Information Technology Standards) as an American National Standard. Date of ANSI Appro

6、val: 7/1/2008 Published by American National Standards Institute, 25 West 43rd Street, New York, New York 10036 Copyright 2008 by Information Technology Industry Council (ITI). All rights reserved. These materials are subject to copyright claims of International Standardization Organization (ISO), I

7、nternational Electrotechnical Commission (IEC), American National Standards Institute (ANSI), and Information Technology Industry Council (ITI). Not for resale. No part of this publication may be reproduced in any form, including an electronic retrieval system, without the prior written permission o

8、f ITI. All requests pertaining to this standard should be submitted to ITI, 1250 Eye Street NW, Washington, DC 20005. Printed in the United States of America Copyright American National Standards Institute Provided by IHS under license with ANSI Not for ResaleNo reproduction or networking permitted

9、without license from IHS-,-,-iiiContents Page Foreword iv Introduction v 1 Scope. 1 2 Conformance. 1 3 Terms and definitions 1 4 Interface architecture 1 5 BAFPI Definition 3 5.1 BAFPI data structures 3 5.1.1 BioAFPI_EventHandler. 3 5.1.2 BioAFPI_BAFPPropertyID 3 5.1.3 BioAFPI_BAFPPropertySchema 4 5

10、.1.4 BioAFPI_UnitPropertyID. 4 5.1.5 BioAFPI_UnitPropertySchema. 5 5.2 BAFP Functions 6 5.2.1 BioAFPI_BAFPLoad 6 5.2.2 BioAFPI_BAFPUnload 7 5.2.3 BioAFPI_UnitAttach 8 5.2.4 BioAFPI_UnitDetach . 9 5.2.5 BioAFPI_QueryUnits. 10 5.2.6 BioAFPI_Free 11 5.2.7 BioAFPI_ControlUnit 12 5.2.8 BioAFPI_Cancel 13

11、5.2.9 BioAFPI_SetPowerMode 14 5.2.10 BioAFPI_DbOpen 15 5.2.11 BioAFPI_DbClose . 16 5.2.12 BioAFPI_DbCreate 17 5.2.13 BioAFPI_DbDelete 18 5.2.14 BioAFPI_DbSetMarker 19 5.2.15 BioAFPI_DbFreeMarker 20 5.2.16 BioAFPI_DbStoreBIR 21 5.2.17 BioAFPI_DbGetBIR . 22 5.2.18 BioAFPI_DbGetNextBIR . 23 5.2.19 BioA

12、FPI_DbDeleteBIR 24 INCITS/ISO/IEC 19784-2-20072008 ITIC 2008 - All rights reservedCopyright American National Standards Institute Provided by IHS under license with ANSI Not for ResaleNo reproduction or networking permitted without license from IHS-,-,-iv Foreword ISO (the International Organization

13、 for Standardization) and IEC (the International Electrotechnical Commission) form the specialized system for worldwide standardization. National bodies that are members of ISO or IEC participate in the development of International Standards through technical committees established by the respective

14、 organization to deal with particular fields of technical activity. ISO and IEC technical committees collaborate in fields of mutual interest. Other international organizations, governmental and non-governmental, in liaison with ISO and IEC, also take part in the work. In the field of information te

15、chnology, ISO and IEC have established a joint technical committee, ISO/IEC JTC 1. International Standards are drafted in accordance with the rules given in the ISO/IEC Directives, Part 2. The main task of the joint technical committee is to prepare International Standards. Draft International Stand

16、ards adopted by the joint technical committee are circulated to national bodies for voting. Publication as an International Standard requires approval by at least 75 % of the national bodies casting a vote. Attention is drawn to the possibility that some of the elements of this document may be the s

17、ubject of patent rights. ISO and IEC shall not be held responsible for identifying any or all such patent rights. ISO/IEC 19784-2 was prepared by Technical Committee ISO/IEC JTC 1, Information technology, Subcommittee SC 37, Biometrics. ISO/IEC 19784 consists of the following parts, under the genera

18、l title Information technology Biometric application programming interface: Part 1: BioAPI specification Part 2: Biometric archive function provider interface INCITS/ISO/IEC 19784-2-20072008 ITIC 2008 - All rights reservedCopyright American National Standards Institute Provided by IHS under license

19、with ANSI Not for ResaleNo reproduction or networking permitted without license from IHS-,-,-vIntroduction This part of ISO/IEC 19784 specifies the interface to an archive BFP. An archive BFP is responsible for the storage and management of BIRs. The archive BFP interface covers functions to attach,

20、 detach and operate related functional units by the biometric service provider, to store BIRs, to retrieve information about stored BIRs and to retrieve formerly stored BIRs for further processing by a BSP. ISO/IEC 19784-1 provides a high-level generic biometric authentication model. This part of IS

21、O/IEC 19784 specifies a BSP archive interface. An archive is responsible for the management of biometric data storage. Because of the application-specific requirements of biometric data storage, an archive interface is standardized. The BioAPI Unit where the BIRs are stored is completely under contr

22、ol of the archive BFP. The general model for the handling of BIRs is as if they were data records in a database. INCITS/ISO/IEC 19784-2-20072008 ITIC 2008 - All rights reservedCopyright American National Standards Institute Provided by IHS under license with ANSI Not for ResaleNo reproduction or net

23、working permitted without license from IHS-,-,-Copyright American National Standards Institute Provided by IHS under license with ANSI Not for ResaleNo reproduction or networking permitted without license from IHS-,-,-AMERICAN NATIONAL STANDARD INCITS/ISO/IEC 19784-2-20072008 ITIC 2008 - All rights

24、reserved 11 Scope This part of ISO/IEC 19784 specifies the interface to an archive biometric function provider. NOTE The interface assumes that the archive will be handled as a database, regardless of its physical realization. (Smartcards, tokens, memory sticks, files on hard drives and any other ki

25、nd of memory can be handled via an abstraction layer presenting a database interface.) This part of ISO/IEC 19784 enables any third party to create biometric archive function providers, which may be plugged into any biometric service provider supporting this interface. It is not in the scope of this

26、 part of ISO/IEC 19784 to define security and privacy requirements for storage and management of BIRs. 2 Conformance A conformant BAFP is required to support all functions and parameters specified in this part of ISO/IEC 19784. No subsets of conformant BAFP functions are defined. NOTE BSPs may requi

27、re any of those functions and parameters. 3 Terms and definitions For the purposes of this document, the following terms and definitions apply. NOTE Function names and data element names are not included here, but are defined within the body of this part of ISO/IEC 19784. 3.1 biometric archive funct

28、ion provider BAFP BioAPI component, attached to a BSP via its interface, for storage, management and interchange of BIRs 3.2 biometric archive function provider interface BAFPI BAFP-to-BSP interface which supports the functions to manage the BAFP itself, its databases or BIRs 4 Interface architectur

29、e ISO/IEC 19784-1:2006 specifies the interface at the top of the BioAPI Framework, which a biometric application uses to interact with BSPs, and through that to biometric units either directly or through BFPs (see Figure 1 and Figure 2 of ISO/IEC 19784-1:2006). Information technology Biometric appli

30、cation programming interface Part 2: Biometric archive function provider interface Copyright American National Standards Institute Provided by IHS under license with ANSI Not for ResaleNo reproduction or networking permitted without license from IHS-,-,-2 The BAFPI contains the following types of fu

31、nctions. General BFP management functions, which are called by the BSP to manage the BFP and its associated BioAPI Units. These functions are not directly related to SPI functions: BioAFPI_BAFPLoad; BioAFPI_BAFPUnload; BioAFPI_UnitAttach; BioAFPI_UnitDetach; BioAFPI_QueryUnits; BioAFPI_Free (the rel

32、ation of this function to the respective SPI call depends on the behaviour of the BSP when the BSP copies the data the BFP has allocated memory for then it can immediately send BioAFPI_Free to the BFP, otherwise the BSP will call this function when itself is requested to free the memory for these da

33、ta). Unit management functions: BioAFPI_ControlUnit (this function is directly related to the SPI function); BioAFPI_Cancel (this function can be called in relation to the respective calls of the SPI or the application, but can be called for other reasons from the BSP also when there is no respectiv

34、e request from the BioAPI framework or application; BioAFPI_SetPowerMode (this function is directly related to the SPI function). Database management functions. These functions are directly related to the respective functions of the SPI: BioAFPI_DbOpen; BioAFPI_DbClose; BioAFPI_DbCreate; BioAFPI_DbD

35、elete. Record management functions. These functions are directly related to the respective functions of the SPI: BioAFPI_DbSetMarker; BioAFPI_DbFreeMarker. Data management functions. These functions are directly related to the respective functions of the SPI: BioAFPI_DbStoreBIR; BioAFPI_DbGetBIR; Bi

36、oAFPI_DbGetNextBIR; BioAFPI_DbQueryBIR; BioAFPI_DbDeleteBIR. INCITS/ISO/IEC 19784-2-20072008 ITIC 2008 - All rights reservedCopyright American National Standards Institute Provided by IHS under license with ANSI Not for ResaleNo reproduction or networking permitted without license from IHS-,-,-35 BA

37、FPI Definition 5.1 BAFPI data structures 5.1.1 BioAFPI_EventHandler This defines the event handler interface to receive asynchronous notification of events of type BioAPI_ EVENT from a BioAPI Unit. Example events include insertion or removal of a BioAPI Unit (e.g. insertion or withdrawal of a Smartc

38、ard storing biometric templates for off card or on card matching). This event handler is passed to the BAFP during BioAFPI_BFPLoad. This is the single event handler that all BioAPI Units managed by this BAFP should use to notify the BSP of event types that occur in a loaded BAFP. typedef BioAPI_RETU

39、RN (BioAPI *BioAFPI_EventHandler) (const BioAPI_UUID *BAFPUuid, BioAPI_UNIT_ID UnitID, BioAPI_UNIT_SCHEMA *UnitSchema, BioAPI_ EVENT EventType); BAFPUuid (input) The UUID of the BAFP raising the event. UnitID (input) The unit ID of the BioAPI Unit (biometric archive) associated with the event. UnitS

40、chema (input) The schema of the BioAPI Unit raising the event. EventType (input) The BioAPI_ EVENT that has occurred. 5.1.2 BioAFPI_BAFPPropertyID Defines the UUID of the format of the BioAFPI_BAFPPropertySchema. When a BAFP claims to be conformant to this part of ISO/IEC 19784, it has to use a Prop

41、ertySchema as defined within this part of ISO/IEC 19784. #define (BioAFPI_BAFPPropertyID, 0x561403e5, 0x7d2d, 0x489a, 0x89, 0x41, 0xe7, 0xa9, 0x35, 0x99, 0xcf, 0x9c); INCITS/ISO/IEC 19784-2-20072008 ITIC 2008 - All rights reservedCopyright American National Standards Institute Provided by IHS under

42、license with ANSI Not for ResaleNo reproduction or networking permitted without license from IHS-,-,-4 5.1.3 BioAFPI_BAFPPropertySchema The BioAFPI_BAFPPropertySchema contains information about the function providers capabilities, which are presented to the BioAPI component registry and in the relat

43、ed function calls. The function provider capabilities can differ from the capabilities of a biometric archive unit. The capabilities usuable by a BSP or BioAPI application are the intersection of the BAFP and biometric archive unit capabilities. typedef struct _bioafpi_bafp_property_schema uint32_t

44、MaxRecordLength; uint32_t MaxRecordNumber; uint32_t MaxDatabases; uint32_t MaxResponseTime; BioAPI_POWER_MODE SupportedPowerModes; BioAFPI_BAFP_PROPERTY_SCHEMA, *BioAFPI_BAFP_PROPERTY_SCHEMA_PTR; MaxRecordLength The value defines the maximum length in bytes of a record. A record presents a BIR. A Bi

45、ometric Unit shall use a value smaller or equal to this value in its UnitSchema. A 0 means that no information about the maximum record length is given. MaxRecordNumber The value defines the maximum number of records. A Biometric Unit shall use a value smaller or equal to this value in its UnitSchem

46、a. A 0 means that no information about the maximum number of records is given. MaxDatabases The value defines the maximum number of databases, which can be managed by the AFP at a time. A 0 means that no information about the maximum number of databases is given. MaxResponseTime The value defines th

47、e maximum time in milliseconds a caller of any BAFP function has to wait until the function returns. A Biometric Unit shall use a value smaller or equal to this value in its UnitSchema. A 0 means that no information about the maximum time until the BioAPI Unit returns is given. SupportedPowerModes T

48、he bit mask defining, which power modes can be handled by the BFP. Handling of a power mode means to pass the related function call to the BioAPI Unit, when this supports the mode and to return the error code related to the result of the reaction of the BioAPI Unit. 5.1.4 BioAFPI_UnitPropertyID Defines the UUID of the format of the BioAFPI_UnitPropertySchema. When a BAFP claims to be conformant to this part of ISO/IEC 19784, it has to use a PropertySchema as