ANSI INCITS ISO IEC 19784-1-2006 Information technology - Biometric application programming interface - Part 1 BioAPI specification《信息技术.生物统计应用程序设计接口.第1部分 BioAPI规范》.pdf

1、INCITS/ISO/IEC 19784-1:20062007 (ISO/IEC 19784-1:2006, IDT) Information technology Biometric application programming interface Part 1: BioAPI specificationINCITS/ISO/IEC 19784-1:20062007 (ISO/IEC 19784-1:2006, IDT)Copyright American National Standards Institute Provided by IHS under license with ANS

2、I Not for ResaleNo reproduction or networking permitted without license from IHS-,-,-INCITS/ISO/IEC 19784-1:20062007 ii ITIC 2007 All rights reserved PDF disclaimer This PDF file may contain embedded typefaces. In accordance with Adobes licensing policy, this file may be printed or viewed but shall

3、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 liability in this area. Ad

4、obe 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 suitable for use by ISO

5、 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 Approval: 4/13/2007 Publishe

6、d by American National Standards Institute, 25 West 43rd Street, New York, New York 10036 Copyright 2007 by Information Technology Industry Council (ITI). All rights reserved. These materials are subject to copyright claims of International Standardization Organization (ISO), International Electrote

7、chnical 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 of ITI. All requests pe

8、rtaining 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 without license from I

9、HS-,-,-INCITS/ISO/IEC 19784-1:20062007 ITIC 2007 All rights reserved iiiContents Page Foreword vi Introduction.vii 1 Scope1 2 Conformance .2 3 Normative references2 4 Terms and definitions .2 5 Symbols and abbreviated terms 7 6 The BioAPI architecture8 6.1 The BioAPI API/SPI Architectural Model.8 6.

10、2 The BioAPI BSP Architectural Model 9 6.3 The Component Registry10 6.4 BSP and BFP Installation and De-installation 11 6.5 BSP Load and BioAPI Unit Attachment 12 6.6 Controlling BioAPI Units.13 6.7 BIR Structure and Handling .13 6.7.1 BIR Structure .13 6.7.2 BIR Data Handling .14 7 BioAPI types and

11、 macros .15 7.1 BioAPI.15 7.2 BioAPI_BFP_LIST_ELEMENT 15 7.3 BioAPI_BFP_SCHEMA15 7.4 BioAPI_BIR.16 7.5 BioAPI_BIR_ARRAY_POPULATION17 7.6 BioAPI_BIR_BIOMETRIC_DATA_FORMAT.17 7.7 BioAPI_BIR_BIOMETRIC_PRODUCT_ID.17 7.8 BioAPI_BIR_BIOMETRIC_TYPE.18 7.9 BioAPI_BIR_DATA_TYPE .18 7.10 BioAPI_BIR_HANDLE19 7

12、.11 BioAPI_BIR_HEADER .19 7.12 BioAPI_BIR_PURPOSE.20 7.13 BioAPI_BIR_SECURITY_BLOCK_FORMAT21 7.14 BioAPI_BIR_SUBTYPE21 7.15 BioAPI_BOOL 22 7.16 BioAPI_BSP_SCHEMA22 7.17 BioAPI_CANDIDATE23 7.18 BioAPI_CATEGORY 24 7.19 BioAPI_DATA.24 7.20 BioAPI_DATE .24 7.21 BioAPI_DB_ACCESS_TYPE .25 7.22 BioAPI_DB_M

13、ARKER_HANDLE.25 7.23 BioAPI_DB_HANDLE.25 7.24 BioAPI_DBBIR_ID25 7.25 BioAPI_DTG .25 7.26 BioAPI_EVENT.26 7.27 BioAPI_EVENT_MASK 26 7.28 BioAPI_EventHandler26 7.29 BioAPI_FMR .27 7.30 BioAPI_FRAMEWORK_SCHEMA.27 7.31 BioAPI_GUI_BITMAP.28 Copyright American National Standards Institute Provided by IHS

14、under license with ANSI Not for ResaleNo reproduction or networking permitted without license from IHS-,-,-INCITS/ISO/IEC 19784-1:20062007 iv ITIC 2007 All rights reserved7.32 BioAPI_GUI_MESSAGE 28 7.33 BioAPI_GUI_PROGRESS . 29 7.34 BioAPI_GUI_RESPONSE 29 7.35 BioAPI_GUI_STATE 29 7.36 BioAPI_GUI_STA

15、TE_CALLBACK 29 7.37 BioAPI_GUI_STREAMING_CALLBACK 30 7.38 BioAPI_HANDLE . 30 7.39 BioAPI_IDENTIFY_POPULATION31 7.40 BioAPI_IDENTIFY_POPULATION_TYPE 31 7.41 BioAPI_INDICATOR_STATUS 31 7.42 BioAPI_INPUT_BIR . 31 7.43 BioAPI_INPUT_BIR_FORM 32 7.44 BioAPI_INSTALL_ACTION . 32 7.45 BioAPI_INSTALL_ERROR 32

16、 7.46 BioAPI_OPERATIONS_MASK 32 7.47 BioAPI_OPTIONS_MASK . 33 7.48 BioAPI_POWER_MODE 34 7.49 BioAPI_QUALITY 34 7.50 BioAPI_RETURN . 35 7.51 BioAPI_STRING. 35 7.52 BioAPI_TIME 36 7.53 BioAPI_UNIT_ID 36 7.54 BioAPI_UNIT_LIST_ELEMENT. 36 7.55 BioAPI_UNIT_SCHEMA 36 7.56 BioAPI_UUID . 38 7.57 BioAPI_VERS

17、ION 38 8 BioAPI functions. 39 8.1 Component Management Functions. 39 8.1.1 BioAPI_Init. 39 8.1.2 BioAPI_Terminate. 40 8.1.3 BioAPI_GetFrameworkInfo 41 8.1.4 BioAPI_EnumBSPs. 42 8.1.5 BioAPI_BSPLoad 43 8.1.6 BioAPI_BSPUnload 45 8.1.7 BioAPI_BSPAttach 46 8.1.8 BioAPI_BSPDetach. 48 8.1.9 BioAPI_QueryUn

18、its. 49 8.1.10 BioAPI_EnumBFPs. 51 8.1.11 BioAPI_QueryBFPs. 52 8.1.12 BioAPI_ControlUnit 54 8.2 Data Handle Operations . 55 8.2.1 BioAPI_FreeBIRHandle 55 8.2.2 BioAPI_GetBIRFromHandle. 56 8.2.3 BioAPI_GetHeaderFromHandle. 57 8.3 Callback and Event Operations. 58 8.3.1 BioAPI_EnableEvents 58 8.3.2 Bi

19、oAPI_SetGUICallbacks . 59 8.4 Biometric Operations . 60 8.4.1 BioAPI_Capture. 60 8.4.2 BioAPI_CreateTemplate . 62 8.4.3 BioAPI_Process 64 8.4.4 BioAPI_ProcessWithAuxBIR . 65 8.4.5 BioAPI_VerifyMatch 67 8.4.6 BioAPI_IdentifyMatch. 69 8.4.7 BioAPI_Enroll 72 8.4.8 BioAPI_Verify 74 8.4.9 BioAPI_Identify

20、 . 76 8.4.10 BioAPI_Import. 79 8.4.11 BioAPI_PresetIdentifyPopulation 80 Copyright American National Standards Institute Provided by IHS under license with ANSI Not for ResaleNo reproduction or networking permitted without license from IHS-,-,-INCITS/ISO/IEC 19784-1:20062007 ITIC 2007 All rights res

21、erved v8.5 Database Operations.81 8.5.1 BioAPI_DbOpen.81 8.5.2 BioAPI_DbClose 83 8.5.3 BioAPI_DbCreate.84 8.5.4 BioAPI_DbDelete .85 8.5.5 BioAPI_DbSetMarker.86 8.5.6 BioAPI_DbFreeMarker.87 8.5.7 BioAPI_DbStoreBIR.88 8.5.8 BioAPI_DbGetBIR89 8.5.9 BioAPI_DbGetNextBIR90 8.5.10 BioAPI_DbDeleteBIR.91 8.6

22、 BioAPI Unit operations .92 8.6.1 BioAPI_SetPowerMode.92 8.6.2 BioAPI_SetIndicatorStatus.93 8.6.3 BioAPI_GetIndicatorStatus.94 8.6.4 BioAPI_CalibrateSensor .95 8.7 Utility Functions 96 8.7.1 BioAPI_Cancel.96 8.7.2 BioAPI_Free .97 9 BioAPI Service Provider Interface .98 9.1 Summary 98 9.2 Type Defini

23、tions for Biometric Service Providers .98 9.2.1 BioSPI_EventHandler98 9.2.2 BioSPI_BFP_ENUMERATION_HANDLER .99 9.2.3 BioSPI_MEMORY_FREE_HANDLER .100 9.3 Biometric Service Provider Operations 101 9.3.1 SPI Component Management Operations.101 9.3.2 SPI Data Handle Operations.107 9.3.3 SPI Callback and

24、 Event Operations.108 9.3.4 SPI Biometric Operations .109 9.3.5 SPI Database Operations112 9.3.6 SPI BioAPI Unit operations 114 9.3.7 SPI Utility Functions115 10 Component registry interface 116 10.1 BioAPI Registry Schema.116 10.1.1 Framework Schema.116 10.1.2 BSP Schema 117 10.1.3 BFP Schema.118 1

25、0.2 Component registry functions .119 10.2.1 BioAPI_Util_InstallBSP .119 10.2.2 BioAPI_Util_InstallBFP .120 11 BioAPI error handling .121 11.1 Error Values and Error Codes Scheme.121 11.2 Error Codes and Error Value Enumeration.121 11.2.1 BioAPI Error Value Constants121 11.2.2 Implementation-Specifi

26、c Error Codes.121 11.2.3 General Error Codes .121 11.2.4 Component Management Error Codes123 11.2.5 Database Error Values 124 11.2.6 Location Error Values .125 11.2.7 Quality Error Codes.127 Annex A (normative) Conformance 128 Annex B (normative) CBEFF Patron Format Specification: BioAPI patron form

27、at140 Annex C (informative) Specification overview.145 Annex D (informative) Calling sequence examples and sample code 154 Bibliography167 Copyright American National Standards Institute Provided by IHS under license with ANSI Not for ResaleNo reproduction or networking permitted without license fro

28、m IHS-,-,-INCITS/ISO/IEC 19784-1:20062007 vi ITIC 2007 All rights reservedForeword ISO (the International Organization for Standardization) and IEC (the International Electrotechnical Commission) form the specialized system for worldwide standardization. National bodies that are members of ISO or IE

29、C participate in the development of International Standards through technical committees established by the respective organization to deal with particular fields of technical activity. ISO and IEC technical committees collaborate in fields of mutual interest. Other international organizations, gove

30、rnmental and non-governmental, in liaison with ISO and IEC, also take part in the work. In the field of information technology, 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, P

31、art 2. The main task of the joint technical committee is to prepare International Standards. Draft International Standards 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 nationa

32、l bodies casting a vote. Attention is drawn to the possibility that some of the elements of this document may be the subject of patent rights. ISO and IEC shall not be held responsible for identifying any or all such patent rights. ISO/IEC 19784-1 was prepared by Joint Technical Committee ISO/IEC JT

33、C 1, Information technology, Subcommittee SC 37, Biometrics. ISO/IEC 19784 consists of the following parts, under the general title Information technology Biometric application programming interface: Part 1: BioAPI specification Part 2: Biometric archive function provider interface This is the first

34、 ISO/IEC standard on BioAPI. Previous versions were published by ANSI and the BioAPI Consortium. As the last official non-ISO release was designated Version 1.1, this ISO/IEC 19784-1 version is designated Version 2.0. This is to distinguish the versions of BioAPI products in the marketplace. Copyrig

35、ht American National Standards Institute Provided by IHS under license with ANSI Not for ResaleNo reproduction or networking permitted without license from IHS-,-,-INCITS/ISO/IEC 19784-1:20062007 ITIC 2007 All rights reserved viiIntroduction This part of ISO/IEC 19784, the BioAPI specification, prov

36、ides a high-level generic biometric authentication model suited to most forms of biometric technology. No explicit support for multimodal biometrics is currently provided. An architectural model is described which enables components of a biometric system to be provided by different vendors, and to i

37、nterwork through fully-defined Application Programming Interfaces (APIs). A key feature of the architecture is the BioAPI Framework, which supports calls by one or more application components (provided by different vendors, and potentially running concurrently) using the BioAPI API specification. Th

38、e BioAPI Framework provides this support by invoking (through a Service Provider Interface, SPI) one or more biometric service provider (BSP) components (provided by different vendors, and potentially running concurrently) which can be dynamically loaded and invoked as required by an application com

39、ponent. At the lowest level there is hardware or software that performs biometric functions such as capture, matching, or archiving. These parts of the architecture are called BioAPI Units, and can be integral to a BSP or can be supplied as part of a separate BioAPI Function Provider (BFP) component

40、. Interactions (through the BioAPI Framework) can occur between BSPs from different vendors provided data structures used to record information from the BioAPI Units they access conform to other International Standards, and in particular to ISO/IEC 19794 5. The final component of the BioAPI architec

41、ture is the recognition that a BSP can provide its biometric services either: a) by the use of BioAPI Units that are integral to (that is, directly managed by) the BSP, or b) by invoking, through the BioAPI Function Provider Interface (FPI), one or more BFP components (provided by different vendors)

42、 that manage BioAPI Units that are integral to the BFP. NOTE: A BioAPI Unit may consist of software only, or a combination of software and hardware (e.g., a biometric sensor, archive, or algorithm). For each type of BioAPI Unit supported by a BSP (or BFP) there may be one or more BioAPI Units of tha

43、t type which can be dynamically inserted and removed from the system. Insertion and removal generates events that can be signalled (through the BSP and the BioAPI Framework) to an application. The BioAPI specification covers the basic biometric functions of Enrollment, Verification, and Identificati

44、on (see Annex C), and includes a database interface to allow an application to manage the storage of biometric records through an archive BioAPI Unit managed by a BSP or BFP. This provides for optimum performance (e.g., when performing the biometric Identification function within a large population)

45、 of the archiving and biometric search processes. The interface to the application provides primitives that allow it to manage the capture of biometric samples from a biometric sensor by accessing the corresponding BioAPI Unit, and the use of those biometric samples for Enrollment (storage in an app

46、lication-controlled or BSP-controlled BIR database), and subsequent Verification or Identification against those stored records. This part of ISO/IEC 19784 also specifies the content of a biometric component registry (information about the biometric components that have been installed on the biometr

47、ic system). It also provides a component registry interface for the management and inspection of that registry. This part of ISO/IEC 19784 uses the C programming language (see ISO/IEC 9899) to specify the data structures and function calls that form the BioAPI interfaces. Copyright American National

48、 Standards Institute Provided by IHS under license with ANSI Not for ResaleNo reproduction or networking permitted without license from IHS-,-,-INCITS/ISO/IEC 19784-1:20062007 viii ITIC 2007 All rights reservedClause 6 describes the BioAPI architectural model and its components, and the interfaces t

49、hat are specified between these components. Clause 7 defines the data structures used in the BioAPI. Clause 8 defines the function calls initiated by an application and supported by a conforming BioAPI Framework that are either handled internally by the BioAPI Framework (for example enumeration of installed BioAPI components) or mapped