GB-T 41903.3-2022 信息技术 面向对象的生物特征识别应用编程接口 第3部分：C#实现

信息技术面向对象的生物特征识别2022-12-30发布 Ⅲ V1范围 12规范性引用文件 13术语和定义 14缩略语 15BioAPIC#命名空间的结构 25.1总体结构 25.2BioAPI命名空间 2 26数据类型和常量 2 26.2BFPListElement类 36.3BFPSchema[Serializable()]类 3 46.5BSPSchema[Serializable()]类 66.6Candidate类 7 8 6.18UUID[Serializable()]类 207支持BioAPI_Unit的面向对象的接口 207.1通用要求 20 21 24I 8.1IBFP接口描述 308.2导入接口 8.3属性汇总 8.4事件汇总 8.5方法汇总 9.1IBSP接口描述 339.2导入接口 9.3属性汇总 9.4事件汇总 9.5方法汇总 10框架层 41 11.1BioAPIException;Exception类 4611.2回调函数 48附录A(资料性)调用序列示例和示例代码 参考文献 Ⅱ本文件是GB/T41903《信息技术面向对象的生物特征识别应用编程接口》的第3部分。 本文件修改采用ISO/IEC30106-3:2020《信息技术面向对象的生物特征识别应用编程接口第——本文件的8.1对应ISO/IEC3010——本文件的8.2～8.5对应ISO/IEC301——本文件的9.2～9.5对应ISO/IEC301本文件与ISO/IEC30106-3:2020的技术性差异及其原因如下：——用规范性引用的GB/T41903.1—2022代替了ISO/IEC30106-1:2016,两个文件之间的对应 —6.15.2的单元列表属性定义缺少属性名，增加属性名UnitListElement,以符合C#编程语法——删除了ISO/IEC30106-3:2020的7.4.2.2中CreateTemplate方法的第2个intunitID参—6.7.2.15中第2个枚举常量与第3个枚举常量重名，将第2个枚举常量名修正为RequestPay-—用资料性引用的GB/T16262.1替换了ISO/IEC8824-1;——用资料性引用的GB/T26237请注意本文件的某些内容可能涉及专利。本文件的发ⅢC这样的基于函数的语言并不能很容易地映射到面向对象的编标准的面向对象的BioAPI版本应用的另一个领域是基于面向对象语言的小型计算设备，在这些设备中(就像上面提到的大型应用服务器一样)一个面向对面向对象的应用编程接口需要统一的体系结构，实现语言包括Java、C#和C++等，因此，GB/T41903拟由4个部分构成。本文件与第2部分的语义等价，尽管函数间传递的实际参数不同，但是名称和接口结构相同。同V信息技术面向对象的生物特征识别应用编程接口第3部分：C#实现下列文件中的内容通过文中的规范性引用而构成本文件必不GB/T13000-2010信息技术通用多八位编码字符集(UCS)(ISO/IEC10646:2003,IDT)GB18030信息技术中文编码字符集GB/T41903.1—2022信息技术面向对象的生物特征识别应用编程接口第1部分：体系结构ACBio生物特征认证背景资料(AuthenticationContextforBiometrics)API应用编程接口(ApplicationProgrammingInterfaBDB生物特征数据块(BiometricDataBlock)BFP生物特征识别功能供方(BiometricFunctionProvider)BIR生物特征信息记录(BiometricInformationRecord)BSP生物特征识别服务供方(BiometricServiCBEFF公用生物特征识别交换格式框架(CommonBiometricFMR误匹配率(FalseMatchRate)GUI图形用户接口(GraphicalUserMAC消息鉴别码(MessageAuthentican1URL统一资源定位符(UniformResourceLocator)UUID通用唯一标识符(UniversallyUniqueIdentifier) 此命名空间的描述解释了一个自下而上的结构。第7章介绍了每种单元类型需要实现的接口。值接下来的是BFP接口(第8章)和BSP接口(第9章)的实现规范。这两种接口提供了较低层次的(FunctionProvider框架(第10章，包括框架接口和组件注册表)和应用交互(第11章，包括异常和此命名空间包含实现面向对象的BioAPI(ObjectOrientedB提供了几种数据结构来满足本文件规定的要求。第6章规定了全部的BioAPI.Data的命名空间，其中定义了所有需要的类和枚举。这是在GB/T41903.1—2022的第8章基础上2——int[]Challenge{get;}:当使用ACBio时，返回来自生物特征验证器的挑战。该值应设置为ACBio实例中ACBioContentInformation类型的字段controlValue的值； 者BSP输出的BPUIO索引的初始值。InitialBPUIOIndexOutput与SupremumBPUIOIn-——int[]SupremumBPUIOIndexOutput{get;}:BPUIO索引的上确界，当生成ACBio实例——UnitCategoryTypeUnitCategory{get;set;}:文件的路径，并且包括文件名。路径可能是URL。该字符串由GB18030中规定的字符组成，并与GB/T13000—2010的附录D建立映射关系。当在函数调用中使用BFPSchema—StringProductVersio ——byte[]BFPProperty{get;3 virtualvoidDispose()说明移除当前对象的所有信息，清空以备下次使用异常无表示BIR。简单BIR和复杂BIR都支持ISO/IEC19785(所有部分)中式规范在GB/T41903.1—2022的第7章中给出。——RegistryIDSelfID{get;set;}:见6.13;—byteCBEFFVersion{get;set;}; —RegistryIDBDBFormat{get;set;}:见6.13; BiometricSubtypeBDBBiometricSubtype{ RegistryIDBDBFeatureExtractionAlg{get;set;}:见6.13 RegistryIDBDBCompresionAlg{get;set;}:见6.13; RegistryIDBDBPADTechnique{get;se—byte[]BDBChallengeResponse{get;se——DateBDBCreationDate{get;set;}:见6.8;—byte[]BDBIndex{get;set; —RegistryIDBDBProduct{get;set;):见6.13; —List(Date)BDBValidityPeriod{get;set;};//2dates,见6——DateBIRCreationDate{get;set;}:见6.8;4——byte[]BIRPayload——List<Date〉BIRValidityPeriod{get;set;};//2dates,见6.8——RegistryIDSBFormat{get;set;}:见6.13;——byte[]SBData{get;set;说明使用编码为自标识(self-identifying)记录的字节数组填充BIR19785-3和ISO/IEC19785-4的相关条款描述的一样异常如果输入的参数无效，格式不被支持或者由于错误导致操IException,见11.16.4.3.2virtualBIR(RegistryIDbDBFormat,boolbDBEncripbDBFeatureExtractionAlg,RegistryIDbDBComparisonAlg,RegistryIDbDBCompresionAlbDBPADTechnique,byte[]bDBChallengeResponse,DatebDBCreationDate,byte[]bDBIndex,Pro-tryIDbDBQualityAlg,List<Date)bDBValidityPeriod,DatebIRCreationDate,bbIRIndex,byte[]bIRPayload,bytesBFormat,byte[]bDBData,b说明异常如果输入的参数无效，格式不被支持或者由于错误导致操IException,见11.1说明序列化BIR记录，以使其作为表示CBE异常如果输入的参数无效，格式不被支持或者由于错误导致IException,见11.156.4.3.4virtualvoidDispos说明移除当前BIR中所有信息，清空以备下次使用异常无—UUID Path{get;};一个指向以NULL结束的字符串的指针，该字符串包含BSP可执行代码文件的路径，并且包括文件名。路径可能是URL。该字符串由GB18030中规定的字符组成，并与GB/T13000—2010的附录D建立映射关系。当在函数调用中使用BioAPI_BSP_ —List<RegistryID》BSPSupportedFormats( List(BSPSchemaOperations)Operations{get;}:BSP支持的生物特征识别操作列表，见6.7. intAdditionalDataPolicy(get;);设置的阈值(FMR最大值),用于决定验证成功后何时释放—intMaxAdditionalDataSize{get intDefaultVerifyTimeout{get;}:当应用未规定超时时，BSP使用的用于Verify操作的默认 intDefaultIdentifyTimeout{get;}:当应用未规定超时时，BSP使用的用于Identify操作的默 intDefaultCaptureTimeout{get;}:当应用未规定超时时，BSP使用的用于Capture操作的默 intDefaultEnrolTimeo intDefaultCalibrateTimeout{get;};当应用未规定超时时，BSP使用的用于Calibrate操作的 intMaxBSPDbSize{get;);BSP控制的BIR数据库的最大容量。它仅适用于BSP只能直接管6理单个存档单元的情况。值为0表示没有提供关于数据库容量的信息，原因有以下3个： -intMaxIdentify{get;}:辨识函数支持的最大用户集。如果最大用户集没有限制，则表示为——intMaxNumEnrolInstances{get;}:在一次注册操作中，BSP可以的最大数量。这些信息有可能对使用应用控制的GUI特性—byte[]HostingEndpointIRIResourceIdntifier,IRI),该框架的组件注册表包含BSP的注册。符合本文件的框架应忽略该参数，应用应将其设置为NULL。提供它是为了支持互操作标准，这些标准可以规定在相-UUIDBSPAccessUUID{get;):一个UUID,其在应用范围内是唯一的，应用可以使用该序可以将其设置为任何UUID值。提供它是为了支持互操作标准，这些标准可以规定在相同—List<RegistryID〉BSPSupportedAlgorithms{get;}:BioAPI_ALGORITHM_ID结构的数virtualvoidDis说明移除当前对象的所有信息，清空以备下次使用异常无—UUIDKey{7定义了本文件能够使用的多个数据类型，包含枚举和常量。本文件中未定义的常量值见GB/T41903.1—2022中第8章的规定。说明使用的生物特征数据的子类型(例如指纹模态中使用的具体为/自二进制格式时，应使用GB/T41903.1—2022第型常量枚举常量汇总 说明枚举常量汇总8(续)枚举常量汇总说明定义访问数据库的模式枚举常量汇总——Read:只允许检索记录的访问模式；——ReadWrite:允许添加、删除和检索记录的访问模式；——Write:允许添加和删除记录，但不支持检说明枚举了BSP能够提供给生物特征识别应用的不同操作，见6.5枚举常量汇总——CalibrateSensor(0x00——CheckQuality(0x00—CreateTemplate(0x00——CreateTemplateWithAuxBIR(0x0——EnableEvents(0x00——GetIndicatorStatus(0x00——IdentifyAggregate(0x00——PresetIdentifyPopulation(0x00——ProcessWithAuxBIR(0x01——SetIndicatorStatus(0x00——SetPowerMode(0x00——VerifyAggregated(0x00——VerifyWithAuxBIR(0x09说明枚举BSP可以处理的不同选项，见6.5枚举常量汇总——CaptureMultiple(0x00——CoarseScores(0x00——ComparisonBFP(0x00——GUIProgressEvents(0x000——IdentifyIndicator(0x00——OCC(0x00004000)[on-cardcomparison,原名叫卡上匹配(Match——AdditionalData(0x00——ProcessingBFP(0x00——ProcessMultiple(0x00——QualityIntermediate(0x00——QualityProcessed(0x00——SelfContainedDevice(0x00—SourcePresent(0x00—SubtypeToCapture(0x00——TemplateUpdate(0x00说明定义了引发事件的不同来源种类枚举常量汇总——SourcePresent(0x00——SourceRemoved(0x0说明定义异常事件中错误的引发者，见11.1枚举常量汇总——Framework:由框架组件报告错误。——BSP:由生物特征识别服务供方报告错误。说明枚举常量汇总说明枚举常量汇总说明当调用GUI回调函数时，确定正在执行的操作，见11.2枚举常量汇总说明在BSP发出的GUI事件通知回调将控制权返回给BSP之后，的操作，见11.2枚举常量汇总说明在一个操作中，枚举BSP可能执行的子操作类型，将在GUI事用程序，见11.2枚举常量汇总说明确定BIR的处理级别枚举常量汇总说明定义BIR或过程的目的枚举常量汇总——EnrolForVerificat—EnrolForIdentificac说明枚举常量汇总—RequestAdaptedBIR:请求创建一个BIR,即通过使用输入到生物特征验证中的处理过的BIR来增量更新参考模板——RequestPayload:请求在验证成功后返回Reques——RequestAdditionalData:请求使用附加数据，例如，在审计过程中说明定义BioAPI_Unit支持的安全选项枚举常量汇总——Encryption(Ox00000001):表示BioAPI_Unit支持加密；——MAC(0x00000002):表示BioAPI_Unit支持MAC生成；——DigitalSignature(0x00000004):表示BioAPI_Unit支持数字签名；——ACBioGenerationWithMAC(0x00000010):表示BioAPI_Unit支持使用MAC生成ACBio;——ACBioGenerationWithDigitalSignature(0x00000020):表示BioA说明列出BioAPI_Unit的不同类别枚举常量汇总——Archive:该单元管理BSP的BIR数据库(0x00000001);——Comparison:该单元是比对算法的集合(0x00000002);——Processing:该单元是处理算法的集合(0x00000004);——Sensor:该单元管理硬件传感器(0x00000008);——QualityAssessment:该单元是不同质量评估过程的集合(0x00000010)说明定义指示器状态可能的值枚举常量汇总说明定义单元可能的电源模式枚举常量汇总——Detect:当单元能够检测到主体与传感器的交互时的模式；——Normal:所有功能都可用时的模式；表示日历日期和时间。日期和时间的编码与CBEFF相同，并且——intDayOfMonth{get;se6.8.3.2virtualboolIsLowerOrEqual(intday,intmonth,i6.8.3.4virtualboolIsHig6.8.3.5virtualboolIsH说明将接口中对象的日期和时间与被调用方法的参数所表示的日—IsLowerOrEqual:“参数中的日期和时间”<=“对象的日期和时间”——IsHigherOrEqual:“参数中的日期和时间”>=“对象的日期和时间”(续)——day:与对象日期比较的月中某日；—month:与对象日期比较的月份；——year:与对象日期比较的年份；——hour:与对象日期比较的小时数；——minute:与对象日期比较的分钟数；——second:与对象日期比较的秒数；异常如果输入的参数无效，格式不支持或者由于错误导致操作失败ception,见11.1——UUIDFrameworkUUID(get;}:框架组件的UUID;——StringFwDescription{get;}:包含框架文——StringPath{get;}:一个指向以NULL结束的字符串的指针，该字符串包含框架可执行代码的文件的路径，并且包括文件名。路径可能是URL。该字符串由GB18030中规定的字符组——StringSpecVersion{get;}:实现框架的BioA—byte[]FwProperty{get;}:包含框架属性的缓存区的地址和长度。框架属性的格式和内容可virtualvoidDispose()说明移除当前对象的所有信息，清空以备下次使用异常无—BiometricSubtypeSu——byte[][]Pixel{get;set;说明移除当前对象的所有信息，清空以备下次使用异常无表示在生物特征辨识中进行比对的BIR集合。其提供了单个属性，即使用的用户集的成员列表。List<PopulationMember)PopulationIdentified(get;):BSP可以使用该属性来提供用户集成员说明向用于辨识目的的用户集添加新成员。连续调用该方法以填充用户集成员列表member:添加的成员异常如果输入的参数无效或者由于错误导致操作失败，则抛出BioAPIException,见6.11.3.2virtualvoidDispose()说明清空用于辨识的用户集列表的所有信息异常BioAPIException,见11.1说明说明异常如果操作失败，则抛出BioAPIException,见11.1定义了使用的数据标识或产品标识。包含在ISO/IEC19785-3和/或ISO/IEC19785-4中BIR的——shortType{get;set;}.定义了BioAPLUnit或生物特征识别应用的加密算法和密钥信息，这些信息用于加密/解密生物特征数据、生成/验证BIR的MAC或者数字签名；也提供了哈希算法的信息、关于MAC生成的信——List(SecurityOptionsType)SupportedSecurityOptions{ge——byte[]ENCInfo{get;—byte[]MACInfo(get;);——byte[]SIGNAlg{get;):BioAPI_Unit支持的数字签名给数字签名算法的抽象语法记法一(AbstractSynt——List<BSPSchemaOptions)ACBioOption{get;}:一个掩码，指示BioAPI_Unit支持或执行—byte[]HASHAlgForACBio{get;—byte[]MACInfoForACBio{get;—byte[]SIGNAlgForACBio{get;}:作为SIGNAlg,但用于生成ACBio实例。virtualvoidDispose()说明移除当前对象的所有信息，清空以备下次使用异常无用类别和ID标识选择的BioAPI_Unit列表。该类的对象每个类别最多只能有一个UnitListEle-List<UnitListElement)UnitListElement《get;set;}:选择的单元列表。说明在所选的单元列表中添加一个新的BioAPI_Unit。如果元，则用新单元替换它unitListElement:新单元的类型和UUID的类别异常如果操作失败，则抛出BioAPIException,见11.16.15.3.2intGetUnitID(UnitCategoryTypeunitCategor说明unitCategoryType:请求的unitID的类别异常如果操作失败，则抛出BioAPIException,见11.1。如果没有所选类别的单元，则抛出BioAPIErrUnitCategoryNot说明移除当前对象的所有信息，清空以备下次使用异常无使用类别和ID标识BioAPI_Unit。这些元素的列表用于建立在执行聚合函数期间要考虑的单元。——UnitCategoryTypeUnitCategory{定义生物特征识别单元的属性。没有方法修改已存在的UnitSchema对象。——intUnitID{get;set;}:BioAPI_Un—UUIDUnitProperties(get;}:BioAPI_Unit的属性集的UUID。属性集可以由每个供应商指—UUIDUnitPropertyID{get;}:下列Unit属性结构格式的UUID; -stringSoftwareVersion{get;}:一个包含软件版本的以NULL结束的字符串。若无法获结束的字符串。若无法获结束的字符串。若无法获 -stringHardwareSerialNumber{get;}:一个包含供应商定义的硬件组件的唯一序列号的——boolAuthenticatedHardware{get;}:硬件组件是否经过认证的布尔值；——intMaxBSPDbSize{get;}:如果BioAPI_Unit为Archive单元，为单元 -intMaxldentify(get;):如果BioAPI_Unit为CvirtualvoidDispose()说明移除当前对象的所有信息，清空以备下次使用异常无stance。如果该单元支持ACBio,那么该单元应使用最新生成的ACBio实例更新此字段。如果不支持ACBio,则该字段应被固定为NULL。 保存模板的最终BIR(例如用户生物特征参考自动更新的情 ——byte[]AuxiliaryDat—UnitIndicatorStatusIndicatorStatus。该接口表示生物特征识别应用或BSP的存档功能。存档系统的具体实现取决于开发者(例如文件说明关闭对开发单元的数据库的访问unitID:执行操作的BioAPI_U异常如果操作失败，则抛出BioAPIException,见11.1说明——unitID:执行操作的BioAPI_Unit的ID;异常抛出BioAPIException,见11.1说明获取具体记录——unitID:执行操作的BioAPI_Unit的ID;异常其他类型的错误，则抛出BioAPIException,见11.1说明unitID:执行操作的BioAPI_U异常BioAPIException,见11.1说明将BSP或BFP使用的数据库设置为辨识操作的数据源。这也unitID:执行操作的BioAPI_U异常BioAPIException,见11.1说明将BSP或BFP使用的数据库设置为辨识操作的数据源。这也——unitID:执行操作的BioAPI_Unit的ID;——UUIDList:包含在新的辨识用户异常抛出BioAPIException,见11.17.2.2.7IdentifyPopulationNewIdentifyPopulation(intunitID,byte[]query)说明将BSP或BFP使用的数据库设置为辨识操作的数据源。这也-unitID:执行操作的BioAPI_Unit的ID;(续)异常他类型的错误，则抛出BioAPIException,见11.1说明打开BSP或BFP管理的数据库。同一单元内，不应同时打开其他数据库。如果之前使用了不同的数据库，应在调用OpenDatabase之前调用Clos——unitID:执行操作的BioAPI_Unit的ID;——dastabaseID:指定要打开的数据库的可选标识符。当不同的数据库能够与单个存档单元一起使用时，所有数据库应与存档单元的元不允许选择不同的数据库，那么这个参数应有一个NULL值；-access:指定对打开的数据库的访问模式(读/写)异常BioAPIException,见11.1说明将指定的BIR添加到无UUID的数据库，允许单元返——unitID:执行操作的BioAPI_Unit的ID;—biometricReference:要存异常抛出BioAPIException,见11.17.2.2.10voidStoreBIR(int说明将指定的BIR添加到数据库，并为其分配提供的UUID。如果已经分配了UUID,则抛出异常。如果程序想要更新现有的UUID,应用程序它，然后重新使用UUID。这样做是为了避免非有意的覆盖——unitID:执行操作的BioAPI_Unit的ID;——biometricReference:要存储的指定BIR;(续)异常如果数据库关闭，或者数据库以只读模式打开，或者UUID已经被使用了，或者任何其他类型的错误，则抛出BioAPIException,见11.17.2.2.11UUIDStoreBIR(intunitID,BIRbiometricReference,byte[]au说明将指定的无UUID的BIR添加到数据库，允许单元返回分配的UUID。在AuxiliaryData(辅助数据)中提交一组附加信息的字节。单元理解(未在本文件规定)。例如，这些信息可以是—unitID:执行操作的BioAPI_Unit的ID;——biometricReference:要存储的指定的BIR;——auxiliaryData:存储到数据库的，与所存储的BI异常抛出BioAPIException,见11.17.2.2.12voidStoreBIR(intunitID,BIRbiometricReference,byte[]auxiliaryData,UUIDkey)说明将指定的BIR添加到数据库，并为其分配提供的UUID。如果已经分配了UUID,则抛出异常。如果程序想要更新现有的UUID,应用程序它，然后重新使用UUID。这样做是为了避免非有意的覆盖。在AuxiliaryData(辅助数据)中提——unitID:执行操作的BioAPI_Unit的ID;——biometricReference:要存储的指定的BIR;——auxiliaryData:存储到数据库的，与所存储的BIR相关的附加数据；异常如果数据库关闭，或者数据库以只读模式打开，或者UUID已经在使用中了，或者任何其他类型的错误，则抛出BioAPIException,见11.1该接口包含执行生物特征比对功能所需的所有属性和方法。定义了一些属性来返回Verify方法在该单元中，使用了FMR术语。FMR将误匹配率表示为一个32bit(比特)的整数值(N),表示可说明unitID:执行操作的BioAPI_U异常如果出现任何错误，则抛出BioAPIException,见11.1说明获取先前比对中获得的FMR值unitID;执行操作的BioAPIU获得的FMR值异常如果出现任何错误，则抛出BioAPIException,见11.17.3.2.3List<Candidate)Identify(intunitID,intbinning,intmaxResults,intauxiliaryBIRs,boolbinning,intmaxResult说明PresetIdentifyPopulation提前确定。为了更好地适应比对算法，定义了重载方法，以(续)——unitID:执行操作的BioAPIUnit的ID;——maxFMRrequested:成功辨识所要求的FMR标准(即；比对阈值)——processedBIR:待辨识的—auxiliaryBIRs:可选项，用于提高比对算法性能的辅助BI——binning:表明分箱是否运行或关闭的布尔搜索技术。根据生物特征数据的固有特性，它基于用户集的子集进行搜索这样虽然能够提高比对操作的速度，但也增加了漏掉某些候选者的可能性(由匹配的BIR的分箱的情况);—timeout:表示操作超时的整数值(以毫秒为单位)。如果达出异常。这个值可以是任何正数。“一1”表示要使用BSP默认超时值异常如果输入的参数无效，或者由于错误导致操作失败，则抛出BioAPIException,见7.3.2.5voidPresetIdentifyPopulation(intunitID,Identifypopu说明向比对单元提供BIR用户集。成功调用此方法后，BSP可以调用Identify()。B或会话终止——unitID:执行操作的BioAPI异常如果输入的参数无效，或者由于错误导致操作失败，则抛出BioAPIException,见说明对现有的生物特征样本进行生物特征验证。该函数在两个BIR特征参考)之间执行验证(一对一)比对。输入BIR是专门为验证而构造的经过处理的BIR。参考模板是在注册时创建的。应用应为成值标准(阈值)该方法的布尔输出表示验证是否成功，以及内部属性(FMRAchiev和AdditionalData)是否被更新。通过设置RequestAdapted求通过使用输入的处理过的BIR更新参考模板来构造BIR,如果比对成功，可以尝试使用输入BIR的信息来更新执行更新操作)。最终得到的、经过更新的BIR,宜被认为是是或丢弃这些数据取决于应用)。需要注意的是，更如果additionalData与参考模板相关，并且达到的FMR足够严格，则在验证成功后可返回additionalData:这由BSP的策略控制，并在其模式中规定。通过设置RequestAdditionalData选项，请求返回additionalData。该接口的Get函数提供了对结果的不同访问方式。该方法被一个附加参数重载，该参数声明一个辅助B—unitID:执行操作的BioAPI——maxFMRrequested:比对阈值；——processdBIR:待辨识的BIR,见6.4;—auxiliaryBIRs:可选项，用于提高比对算法性能的辅——referenceTemplate:用于验证的参考——Options:请求附加输出，例如更新的BIR和/或additio表示生物特征验证操作结果的布尔判定异常如果输入的参数无效，或者由于错误导致操作失败，则抛出BioAPIException,见7.4.2.1BIRCreateTemplate(intunitID,BFormat,byte[]addition7.4.2.2BIRCreateTemplate(intunitID,List<BIR)capturedBIRs,BIRreoutputFormat,byte[]addit说明获取包含生物特征数据的BIR或BIR列表，用于创建以从采集的BIR构造，也可以基于现有的参考模板进行更新。如果BSP支持此功能，则提供可选的输入参考模板用于创建新模板——unitID:执行操作的BioAPIUnit的ID;——capturedBIR:采集的BIR,见6.4;—capturedBIRs;采集的BIR列表，见6.4;——referenceTemplate:可选项，待更新的已存在——outputFormat;如果BSP支持多种格式，则指定返回的已处理过的BIR使用哪种BDB格式。NULL值表示BSP要选择格式，见6.13——additionalData:BSP将要存储的additi异常如果输入的参数无效，格式不支持或者由于错误导致操作失败ception,见11.7.4.2.3BIRProcess(intunitID,BIRcap说明——unitID:执行操作的BioAPIU——capturedBIR:采集的BIR,见6.4;——auxiliaryBIR:操作中使用的包含辅助数据的BIR,见6.4, —outputFormat:如果BSP支持多种格式，则指定返回的已处理过的BIR使用哪种BDB格式。NULL值表示BSP要选择格式。见6.13异常7.4.2.5byteAnalyseQuality(intunitID说明处理采集的生物特征样本，以分析其质量并返回一个质量得分——unitID:执行操作的BioAPI_Unit的ID;质量得分，可以是0(最低质量)到100(最高质量)之间的异常如果输入的参数无效，或者由于错误导致操作失败，则抛出BioAPIException,见说明如果传感器支持，则对传感器进行校准—unitID:执行操作的BioAPI_Unit的ID;异常如果输入的参数无效，或者由于错误导致操作失败，则抛出BioAPIException,见7.5.2.2BIRCapture(intunitID,List《PurpoputFormat,inttimeout,List<ResultOptions)说明采集BIR的数据头。如果指定了RequestAuditData选项，则可以在CaptureResult中返回原始类型的BIR(续)——unitID:执行操作的BioAPIUnit的ID;——purpose:表示采集生物特征数据的目的——subtype:表示采集的生物特征样本的子类型。NULL表示6.7.2.1;-outputFormat:如果BSP支持多种格式，则指定返回的、已处理的BIR使用哪种BDB格式。NULL表示BSP要选择格式。见6.13——timeout:表示操作超时值的整数值(以毫秒为单位)表示采集操作结果的BIR对象(见6.4)异常如果传感器设备正被占用，或者操作失败，则抛出BioAPIException,见11.说明获取指示器当前状态的函数unitID:执行操作的BioAPIU异常如果出现任何错误，则抛出BioAPIException,见11.1说明如果BioAPIUnit支持，则该函数将所选的BioAPIU状态。在IndicatorStatus参数中设置Accept或Reiect之后，直到应用——unitID:执行操作的BioAPIU——indicatorStatus;设置BioAPIUnit指示器状态的值异常如果出现任何错误，则抛出BioAPIException,见11.1表示生物特征识别功能供方。该接口由BFP功能和BFP支持的BioAPI_Unit的集合组成。在同——BFPSchemaBFPSchema{get;set;};——byte[]ACBioInstance{get;——BFPGUIProgressCallbackBFPGUICallback事件。8.5.2voidBFPLoad(BFPEventCallb说明初始化BFP。初始化包括为指定的BFP注册BSP事件句柄并激活所有事件。BSP可以选择提供一个事件句柄函数来接收事件通知。许多BSP可以发地加载相同的BFP,并且每个BSP可以建立自己的事件句柄。它们都将收到事件通知。如果一个BSP加载多个BFP,则可以使用相同或不同的事件句柄。通过一次或多次调用BFPLoad,BSP可以为指定的BFP建立任意数量的事件句当事件在BFP中发生时，BFP可以通过调用BSP的事件句柄向BSP如果BSP已经设置了多个事件句柄，则应按BFP选择的任意顺序一次调用一个事件通知可以在任何时候发生，无论是在BSP调用期间(与是在执行时没有BSP调用时。无论BSP何时接收回调，BSP开发者宜确保所有回当加载BFP(BFPLoad)时，它应立即为每个当前的BioAPI_Unit引发一个“插入”入”事件。BFPNotifyCallback定义一个回调函数，用于向BSP通知BioAPI_EVE事件。BFP应保留此信息以备后续使用(续)bfpNotifyCallback:定义一个回调，用于向BioAP异常如果任何参数无效或者初始化过程中出现任何其他错误，则抛出BioAPIException,见11.1说明禁用事件并注销当前已与BSP创建链接的BFP的使用异常如果任何参数无效或者初始化过程中出现任何其他错误，则抛出BioAPIException,见11.18.5.4byte[]ControlUnit(intunitID,intcontrolCode,byte[]inputDa说明向BioAPI_Unit发送控制数据并从那里接收状态或操作数据。参数和输出的内容将在BioAPI_Unit的相关接口规范中指定。层上需要，因此这些相关内部方法调用的方式依赖于实现，这超出了本文件的范围——unitID:执行操作的BioAPI_Unit的ID;—controlCode:在BioAPI_Unit中被调用的函数编码；——inputData:包含将被发送到BioAPI_Unit的，与给定的ControlCode相关的数据的缓存区包含在处理了ControlCode所指示的函数之后，从BioAPI_Un异常如果出现任何错误，则抛出BioAPIException,见11.1说明执行操作后，从引用的BioAPI_Unit(如传感器)获得任何可用的辅助数据。unitID:执行操作的BioAPI_U在处理完前面的函数后，包含从BioAPI_Unit接收到的辅助数据的数据缓存异常如果出现任何错误，则抛出BioAPIException,见11.1见8.5.7。8.5.7List<UnitSchema)QueryUnits(List<UnitCategoryType)unitCategories)说明该函数返回由给定的BFP管理的，并且当前处于插入状态的BioAPI_Unit模式列表。BFP中的所有单元应有定义的UnitSchema。对于给定的BioAPIUnit,不要求该函数返回的单元ID由BS值提供给框架。BSP可以自由地将BFP提供的任何单元IID值，然后再提供给框架。这种转换的目的是避免在BSP的范围内存在重复的单元ID。当BSP使用两个或更多相同类别的BFP;或者(BFP中的传感器单元),与此同时直接管理生物特征传感器时，重复可能发生UnitSchema列表，其中每个元素描述当前会话中每个可用异常如果无法访问BFP,则在调用该方法时抛出BioAPIException,见11.18.5.8voidSetPowerMode(intunitID,Un说明如果BioAPIUnit支持，该函数将加载的BSP所引用的Bio的电源模式——unitID:执行操作的BioAPIUnit的ID;——poewrMode:设置BioAPI_Unit的异常如果出现任何错误，则抛出BioAPIException,见11.1表示生物特征识别服务供方。它是会话对象的工厂，提供对生物特征识别操作的访问。该接口由BSP的功能和BSP支持的BioAPI_Unit的集合组成。它还可以支持与BFP和组件注册表的通信。BSP开发者可以决定不向外界提供所支持的BioAPI_Unit的某些功能的调用，而是发起一个Bio-APIException,表明不支持这样的方法。此外，通过继承IBSPUnitSet接口添加与框架交互所需的方法和属性。 byte[]ACBioInstance{geBSPEventCallbackB9.5.2voidBSPLoad(BSPEventCallbackbspNotifyCallback,B说明初始化BSP。如果没有对BSPUnload()的——bspNotifyCallback;定义用于将事件通知BioAPI框架的回调——bfpEnumerationCallb知道在生物识别系统中安装了哪些BFP异常如果任何参数无效，或初始化过程中出现任何其他错误，则抛出BioAPIException,见11.1说明禁用事件并在应用中注销当前BSP的使用异常如果任何参数无效，或初始化过程中出现任何其他错误，则抛出BioAPIException,见11.19.5.4byteCheckQuality(BIRinp说明该函数对包含在输入BIR中的生物特征数据进行质量评价。如果指定了质量算法，并且BSP支持该算法，则应使用该算法。如果为NULL,则BSP将选择要应用的质量算法。BSP可以通过调用BioAPIEnumBSP持哪些质量算法。如果请求的是不支持的算法，则应抛出BioAPIERR_PORTED_ALGORITHMBioAPIExc——inputBIR:包含需要评价质量的生物特征数据的BIR; 异常如果有任何错误，则抛出BioAPIException,见11.19.5.5byte[]ControlUnit(intunitID,intcontrolCode,byte[]inputData)说明将控制数据发送给BioAPIUnit,并从那里接收状态或操作数据。参数和输出的内容将在BioAPI_Unit相关的接口规范中指定。——unitID:执行操作的BioAPI——controlCode:被调用的BioAPI_Unit中的函数编码；——inputData:包含要发送到BioAPI_Unit的，与给定的ControlCode相关的数据的缓存区包含在处理了ControlCode所指示的函数后，从BioAPIUni异常如果有任何错误，则抛出BioAPIException,见11.19.5.7UUIDEnrol(UnitListunitList,List(BIR)capturedBIRs,9.5.8UUIDEnrol(UnitListunitList,intnumceTemplate,List(Purpose)puralData,inttimeout,List<Resul9.5.9UUIDEnrol(UnitListunitList,BIRcapturedBIR,UUIDrefe9.5.10UUIDEnrol(UnitListunitList,List(BIR)capturedBIRs,enceID,List<Purpose)purpose,BiometricSubtypeadditionalData,inttimeout,List(Resu说明按照上述列表中出现的顺序，通过下列方法注册用户—在该方法的第一个参数中提供用于注册的样本；——在该方法的第一个参数中提供用于注册的样本列表；——要求BSP中的传感器单元进行一定次数的采集。注册可以从头开始，或者更新先前的注册。在第一种情况下，参数Replate或ReferenceID应是NULL。在第二种情况下，可以通过BIR(使用Referen-ceTemplate)或UUID(使用ReferenceID)提供要更新的生物成功注册的结果；给创建的生物特征参考分配的UUID,以及该生物特征参考的BIR(可选),它将位于BiometricReference属性中。如果出于任何原因考虑),BSP不想发布生成的生物特征参考，则该属性应设置为NULL,BSP负责提供与注册操作相关的默认用户接口。应用可以通过BSP.Subscribe-ToGUIEvents()方法提供GUI回调请求对GUI“外观”的控制。由于E作包括采集，所以它序列化了传感器设备的使用。如果有两个或两个以上应用在争用该设备，则失败的应用将等待操作完成或超时过期。这种序列化发生在所有采集数据的函数中。BSP负责序列化。它可以通过抛出异常来表明设备正忙，或者通过排队请求来实现这一点(续)——unitList:执行操作的BioAPI_Unit;—capturedBIR:可选项，用于注册的BIR格式的生物特征样本，见6.4;capturedBIRs:可选项，用于注册的生物特征样本的BIR列表，见6.4;numberOfPresentations:当注册样本在BSP内采集时，该得的样本数量；numberOfAttempts:在返回一个注册失败(FTE)异常之前一个呈现(presentation)应进行的最大尝试次数——referenceTemplate:可选项，将被更新的生物特征参考的BIR,见6.4;——referenceID:可选项，将被更新的生物特征参考的UUID;ficationonly)的值；——subtype:表示注册的子类型(例如左/右眼)。NULL值表示类型，见6.7.2.1;outputFormat:如果BSP支持多种格式，该参数规定返回的N用哪种BDB格式。NULL值表示BSP要选择格式，见6.13——additionalData:BSP将要存储的additionalData;—timeout:表示操作超时值的整数值(以毫秒为单位),如果达到此超时值，函表示将使用BSP默认超时值；options:请求附加输出，例如审计数据。这些数据供与人相关的人类可识别的数据异常如果参数错误，或者在处理过程中出现其他错误(例如不能访问数据库),则抛出BioAPIException,见11.1说明在执行操作后，从引用的BioAPI_Unit(如传感器)获取任何可用的辅助数据。unitID:执行操作的BioAPI_异常如果出现任何错误，则抛出BioAPIException,见11.19.5.13List(Candidate)IdentifyAggregated(UnitLisBiometricSubtypesubtype,boolbinning,intmaxResults,inttimeout,List(ResultOptions)options)说明该方法提供了聚合功能。它增加了IComparison(见7.3)中的Identify方法的功能。当BSP调用自己的传感器单元直接采集生物特征样本时，或者通过以原始的或处理过的格式提供输入BIR时，它允许进行辨识操BSP负责提供与注册操作相关的默认用户接口。应用程序可以通过BSP.SubbeToGUIEvents()方法提供GUI回调来请求对GUI“外观”的控制作包括采集，所以它序列化了传感器设备的使用。如果有两个或两个以上应用在争用该设备，则失败的应用将等待操作完成或超时过期。这种序列化发生在所有采集数据的函数中。BSP负责序列化。它可以通过抛出异常来表明设备正忙，或者通过排队请求来实现这一点—unitList:执行操作的BioAPIUnit——timeout:表示操作超时值的整数值(以亲秒为单位)。如果达到此超时值，则抛出异常。这个值可以是任何正数。“一1”表示将使用BSP默认超时值；-options:请求附加输出，例如审计数其他参数见IComparison(7.3)中异常如果出现任何Capture异常(7.5)或者Identify异常(7.3),则抛出BioAPIException,见11.1说明返回当前会话中BSP支持的可用的BFP的标unitCategories:可选项，请求枚举的单元模当前BSP支持的BFP列表异常BioAPIException,见11.19.5.18List<UnitSchema)QueryUnits(List《UnitCategoryType)unitCategories)说明BSP返回可用的单元。BSP中的所有单元应有一个定义的UnitSunitCategories:可选项，请求枚举的单元模UnitSchemas列表，其每个元素描述了每个可用异常如果在BSP被卸载后调用该方法，则抛出BioAPIException,见11.1metricSubtypesubtype,inttimeout,Li9.5.20boolVerifyAggregated(UnitListunitList,ienceKey,BiometricSubtypesu说明该方法提供聚合功能。它从IComparison(见7.3)中增加了Verify方法的功能，允——BSP通过调用自己的传感器单元直接采集生物特征样本。因——以原始或处理过的格式提供生物特征样本—由其UUID声明生物特征参考。因此，增加了refere——提供作为BIR的生物特征参考。因此，使用了referenceTe——BSP本质上知道生物特征参考(例如单个用户、单个注册应用)。因此，调用将以NULL作为referenceTemplate或referenceKey。进一步的说明见IComparison(7.3)中的VeriBSP负责提供与注册操作相关的默认用户接口。应用程序可以通过BSP.SubbeToGUIEvents()方法提供GUI回调来请求对GUI“外观”的控制作包括采集，所以它序列化了传感器设备的使用。如果有两个或两个以上应用在争用该设备，则失败的应用将等待操作完成或超时过期。这种序列化发生在所有采集数据的函数中。BSP负责序列化。它可以通过抛出异常者通过排队请求来实现这一点(续)——unitList:执行操作的BioAPI_Unit;——referenceKey:用于验证的生物特征参考的UUID;——referenceTemplate;与用于验证的生物特征参——subtype;规定采集的子类型(例如左/右眼)。NULL值表示没有提供该值，见6.7.2.1;——timeout;表示操作超时值的整数值(以毫秒为单位)。如果达到此超时值，则抛出异常。这个值可以是任何正数。“一1”表示将 其他参数见IComparison(7.3异常如果出现任何Capture异常(7.5)或者Verify异常(7.3),则抛出BioAPIException,见11.19.5.23voidSetPowerMod说明如果BioAPI_Unit支持，该函数将加载的BSP中所引用的Bi—unitID:执行操作的BioAPIUnit的ID;——powerMode:设置BioAPI_Unit异常如果出现任何错误，则抛出BioAPIException,见11.1说明该方法为BSP提供Select,State和Progress事件的事件，则应为该类事件提供NULL值。如果将三个事件都设置能调用该方法。如果该方法是用先前已经分配回调函数的确定事件调用，则该方法只需简单的用当前调用中提供的回调地址替换旧的回调地址—guiSelectEventCallbackFunction:为SelectEvent的回调函数指定地址；——guiStateEventCallbackFunction:为StateEvent的回调函数指定地址guiPtogressEventCallbackFunction;为ProgressEvent的回调函数指定地址异常BioAPIException,见11.1说明该方法清除之前订阅的回调地址。调用该函数后，BSP应停止向框架或应用通知异常BioAPIException,见11.1说明在组件注册表中安装或更新对BFP的引用。该函数在BioAP——bfpSchema:指定要安装或更新的BFP的信息 回ERR_COMPONENT_NOT_REGISTEREDBioAPIException)。如果为假，则安装一个新BFP。如果已经安装了BFP,则抛出ERRALREADY_REGISTEREDBioAPIExcept异常如果在安装过程中出现任何错误，则抛出BioAPIException,见11.1说明参数——bspSchema:指定要安装或更新的BSP的信息；回ERR_COMPONENT_NOT_REGISTEREDBioAPIException)。如果为假，则安装一个新BSP。如果已经安装了BSP,则抛出ERRALREADYREGISTEREDBioAPIExcept异常如果在安装过程中出现任何错误，则抛出BioAPIException,见11.110.1.2.3voidUninstallBFP(UUID说明异常如果出现任何错误，则抛出BioAPIException,见11.说明异常如果出现任何错误，则抛出BioAPIException,见11.1表示生物特征识别系统。生物特征识别系统是一个层次结构系统，其根节点及管理传感器硬件的代码。除了BSP,框架的另一部分是组件注册表，它存储关于BSP和BFP的FrameworkSchemaFrameworkSchema{get;}。说明收到事件通知。如果应用加载了多个BSP,那么可以使用相同或不同的事件句柄对于给定的BSP,应用可以通过一次或多次调用BioAPI_BSPLo立任意多的事件句柄。事件句柄由地址和上下文的当BSP中发生事件时，该BSP可以通过调用框架的事件句柄向框架发送事件当框架接收到来自BSP的事件通知时，它应给每个应用创建的每个事件句柄发送一个通知，表明为该BSP启用了事件通知。因此，从BSP到框架的单一事件通知回调，可导致从框架到零个或多个应用的零当框架接收到来自BSP的事件通知时，它应调用每个应用为该BSP所建立的全部事件句柄。如果应用建立了多个事件句柄，则应按照框架个句柄，而不是同时调用，事件通知可能在任何时刻发生，或者在BioAPI调用期间(与事件相关或无关),或者在没有执行BioAPI调用时。无论应用何时接收这些回调，应用开发者都宜确别的每个可用BioAPIUnit的“插入”事件通知。如果生物特征识别应用已经在BSPLoad的调用中提供了一个事件句柄，并且还没有禁用“插入”事件通知，那么框架将依次回调应用的事件句柄。可以通过调用EnableEventNot定功能的硬件组件，则在插入硬件组件之前无法引发“插入”事件。只有当至少有一次对Init的调用且尚未进行相应的Terminate调用时，才会除非使用InstallBSP安装了BSP,否则不应调用BSPLoad函数。通过调用——bspID;标识要初始化的BSP;—notifyCallback:调用方提供的事件通知函数。定义了来自加载的生物特征识别服务供方的事件通知的回调；——bfpEnumerationCallback:调用方提供的事件通知函数。回-context:上下文信息的通用指针。当所选的生物特征识别时，将此值作为输入传递给NotifyCallback指定的事件句柄异常如果框架被终止或者出现任何其他错误，则抛出BioAPIException,见11.1说明为BSPUUID标识的调用方注销事件通知回调，对bspUnload的调用与对bspLoad的调用类似。如果向BioAPI注册的所有回调被移除，那么BioAPI将为该生物特征识别应用卸载通过调的BSP。BioAPI框架使用三个输入参数来唯一标识已注册的回调对于给定的BSPUUID,仅在至少有一次对BSPLoad的调用这包括BioAPI框架在terminate调用期间隐式地执行与缺少对——bspID:标识要初始化的BSP; context;上下文信息的通用指针。当所选的生物特征识别服务供方引发事件时，将此值作为输入传递给NotifyCallback指定的事件句柄异常如果框架被终止或者出现任何其他错误，则抛出BioAPIException,见11.110.2.4.3voidEnableEventNotifications(UUID说明启用Events参数标识的，并且来自于BSPUUID标识的BSP的事件，并禁用来自仅对调用该函数的应用启用或禁用事件。如果有其他应用同时使用架或指定的BSP,这些应用将不会受到调用enableEventNotification的影响该函数可以在BioAPIInit之后的任何时候调用，甚至在加载指定的BSP之前。对该函数的调用所建立的事件参数将一直有效，直到相同的B只有当至少有一次对Init的调用且尚未进行相应的Terminate调用时，才会调用异常如果框架已终止或者出现任何其他错误，则抛出BioAPIException,见11.1说明该函数提供组件注册表中现已安装的所有BFP的信息只有当至少有一次对Init的调用且尚未进行相应的Terminate调用时，才会调用(续)系统中可用的BFP的BFPSchema列表异常如果在框架终止后调用该方法，则抛出BioAPIException,见11.1说明该函数提供组件注册表中现已安装的所有BSP的信息。它使用所有已安装的只有当至少有一次对Init的调用且尚未进行相应的Terminate调用时，才会调用BSPSchemas列表，其每个元素描述了生物特征识别系统中一个可用异常如果在框架终止后调用该方法或出现任何其他错误，则抛出BioAPIException,见说明初始化BioAPI框架，并验证应用预期的BioAPI框架的版本与API框架版本是否兼容。应用应至少调用一次version:与生物特征识别应用相兼容的BioAPI规范的主/次版本号，异常BioAPIException,见11.110.2.4.7List(BFPListElement)QueryBFPs(UUIDbspUUID)说明返回当前安装在组件注册表中，并由给定BSPUUID标识的BSP支持的BFP列表。它按顺序执行以下操作：a)确定当前所有已经安装的BFP中哪些是被BSP支持的；b)用a)中确定的BFP的标识信息(类别和UUID)填充数组。注：该方法调用相应的BSP.QueryBFPs。通过调用enumBFPs并在匹配的BFPUUID上分析BFPSchemaArray,能够取回关于所支持的BFP的附加信息。只有在为指定的BSP调用BSPLoad之后，才能调用该函数，而在为此BSP调用了异常如果出现任何错误，则抛出BioAPIException,见11.110.2.4.8Lis