GB-T 41903.3-2022 信息技術(shù) 面向?qū)ο蟮纳锾卣髯R(shí)別應(yīng)用編程接口 第3部分：C#實(shí)現(xiàn)

信息技術(shù)面向?qū)ο蟮纳锾卣髯R(shí)別2022-12-30發(fā)布 Ⅲ V1范圍 12規(guī)范性引用文件 13術(shù)語(yǔ)和定義 14縮略語(yǔ) 15BioAPIC#命名空間的結(jié)構(gòu) 25.1總體結(jié)構(gòu) 25.2BioAPI命名空間 2 26數(shù)據(jù)類型和常量 2 26.2BFPListElement類 36.3BFPSchema[Serializable()]類 3 46.5BSPSchema[Serializable()]類 66.6Candidate類 7 8 6.18UUID[Serializable()]類 207支持BioAPI_Unit的面向?qū)ο蟮慕涌?207.1通用要求 20 21 24I 8.1IBFP接口描述 308.2導(dǎo)入接口 8.3屬性匯總 8.4事件匯總 8.5方法匯總 9.1IBSP接口描述 339.2導(dǎo)入接口 9.3屬性匯總 9.4事件匯總 9.5方法匯總 10框架層 41 11.1BioAPIException;Exception類 4611.2回調(diào)函數(shù) 48附錄A(資料性)調(diào)用序列示例和示例代碼 參考文獻(xiàn) Ⅱ本文件是GB/T41903《信息技術(shù)面向?qū)ο蟮纳锾卣髯R(shí)別應(yīng)用編程接口》的第3部分。 本文件修改采用ISO/IEC30106-3:2020《信息技術(shù)面向?qū)ο蟮纳锾卣髯R(shí)別應(yīng)用編程接口第——本文件的8.1對(duì)應(yīng)ISO/IEC3010——本文件的8.2～8.5對(duì)應(yīng)ISO/IEC301——本文件的9.2～9.5對(duì)應(yīng)ISO/IEC301本文件與ISO/IEC30106-3:2020的技術(shù)性差異及其原因如下：——用規(guī)范性引用的GB/T41903.1—2022代替了ISO/IEC30106-1:2016,兩個(gè)文件之間的對(duì)應(yīng) —6.15.2的單元列表屬性定義缺少屬性名，增加屬性名UnitListElement,以符合C#編程語(yǔ)法——?jiǎng)h除了ISO/IEC30106-3:2020的7.4.2.2中CreateTemplate方法的第2個(gè)intunitID參—6.7.2.15中第2個(gè)枚舉常量與第3個(gè)枚舉常量重名，將第2個(gè)枚舉常量名修正為RequestPay-—用資料性引用的GB/T16262.1替換了ISO/IEC8824-1;——用資料性引用的GB/T26237請(qǐng)注意本文件的某些內(nèi)容可能涉及專利。本文件的發(fā)ⅢC這樣的基于函數(shù)的語(yǔ)言并不能很容易地映射到面向?qū)ο蟮木帢?biāo)準(zhǔn)的面向?qū)ο蟮腂ioAPI版本應(yīng)用的另一個(gè)領(lǐng)域是基于面向?qū)ο笳Z(yǔ)言的小型計(jì)算設(shè)備，在這些設(shè)備中(就像上面提到的大型應(yīng)用服務(wù)器一樣)一個(gè)面向?qū)γ嫦驅(qū)ο蟮膽?yīng)用編程接口需要統(tǒng)一的體系結(jié)構(gòu)，實(shí)現(xiàn)語(yǔ)言包括Java、C#和C++等，因此，GB/T41903擬由4個(gè)部分構(gòu)成。本文件與第2部分的語(yǔ)義等價(jià)，盡管函數(shù)間傳遞的實(shí)際參數(shù)不同，但是名稱和接口結(jié)構(gòu)相同。同V信息技術(shù)面向?qū)ο蟮纳锾卣髯R(shí)別應(yīng)用編程接口第3部分：C#實(shí)現(xiàn)下列文件中的內(nèi)容通過(guò)文中的規(guī)范性引用而構(gòu)成本文件必不GB/T13000-2010信息技術(shù)通用多八位編碼字符集(UCS)(ISO/IEC10646:2003,IDT)GB18030信息技術(shù)中文編碼字符集GB/T41903.1—2022信息技術(shù)面向?qū)ο蟮纳锾卣髯R(shí)別應(yīng)用編程接口第1部分：體系結(jié)構(gòu)ACBio生物特征認(rèn)證背景資料(AuthenticationContextforBiometrics)API應(yīng)用編程接口(ApplicationProgrammingInterfaBDB生物特征數(shù)據(jù)塊(BiometricDataBlock)BFP生物特征識(shí)別功能供方(BiometricFunctionProvider)BIR生物特征信息記錄(BiometricInformationRecord)BSP生物特征識(shí)別服務(wù)供方(BiometricServiCBEFF公用生物特征識(shí)別交換格式框架(CommonBiometricFMR誤匹配率(FalseMatchRate)GUI圖形用戶接口(GraphicalUserMAC消息鑒別碼(MessageAuthentican1URL統(tǒng)一資源定位符(UniformResourceLocator)UUID通用唯一標(biāo)識(shí)符(UniversallyUniqueIdentifier) 此命名空間的描述解釋了一個(gè)自下而上的結(jié)構(gòu)。第7章介紹了每種單元類型需要實(shí)現(xiàn)的接口。值接下來(lái)的是BFP接口(第8章)和BSP接口(第9章)的實(shí)現(xiàn)規(guī)范。這兩種接口提供了較低層次的(FunctionProvider框架(第10章，包括框架接口和組件注冊(cè)表)和應(yīng)用交互(第11章，包括異常和此命名空間包含實(shí)現(xiàn)面向?qū)ο蟮腂ioAPI(ObjectOrientedB提供了幾種數(shù)據(jù)結(jié)構(gòu)來(lái)滿足本文件規(guī)定的要求。第6章規(guī)定了全部的BioAPI.Data的命名空間，其中定義了所有需要的類和枚舉。這是在GB/T41903.1—2022的第8章基礎(chǔ)上2——int[]Challenge{get;}:當(dāng)使用ACBio時(shí)，返回來(lái)自生物特征驗(yàn)證器的挑戰(zhàn)。該值應(yīng)設(shè)置為ACBio實(shí)例中ACBioContentInformation類型的字段controlValue的值； 者BSP輸出的BPUIO索引的初始值。InitialBPUIOIndexOutput與SupremumBPUIOIn-——int[]SupremumBPUIOIndexOutput{get;}:BPUIO索引的上確界，當(dāng)生成ACBio實(shí)例——UnitCategoryTypeUnitCategory{get;set;}:文件的路徑，并且包括文件名。路徑可能是URL。該字符串由GB18030中規(guī)定的字符組成，并與GB/T13000—2010的附錄D建立映射關(guān)系。當(dāng)在函數(shù)調(diào)用中使用BFPSchema—StringProductVersio ——byte[]BFPProperty{get;3 virtualvoidDispose()說(shuō)明移除當(dāng)前對(duì)象的所有信息，清空以備下次使用異常無(wú)表示BIR。簡(jiǎn)單BIR和復(fù)雜BIR都支持ISO/IEC19785(所有部分)中式規(guī)范在GB/T41903.1—2022的第7章中給出?！猂egistryIDSelfID{get;set;}:見(jiàn)6.13;—byteCBEFFVersion{get;set;}; —RegistryIDBDBFormat{get;set;}:見(jiàn)6.13; BiometricSubtypeBDBBiometricSubtype{ RegistryIDBDBFeatureExtractionAlg{get;set;}:見(jiàn)6.13 RegistryIDBDBCompresionAlg{get;set;}:見(jiàn)6.13; RegistryIDBDBPADTechnique{get;se—byte[]BDBChallengeResponse{get;se——DateBDBCreationDate{get;set;}:見(jiàn)6.8;—byte[]BDBIndex{get;set; —RegistryIDBDBProduct{get;set;):見(jiàn)6.13; —List(Date)BDBValidityPeriod{get;set;};//2dates,見(jiàn)6——DateBIRCreationDate{get;set;}:見(jiàn)6.8;4——byte[]BIRPayload——List<Date〉BIRValidityPeriod{get;set;};//2dates,見(jiàn)6.8——RegistryIDSBFormat{get;set;}:見(jiàn)6.13;——byte[]SBData{get;set;說(shuō)明使用編碼為自標(biāo)識(shí)(self-identifying)記錄的字節(jié)數(shù)組填充BIR19785-3和ISO/IEC19785-4的相關(guān)條款描述的一樣異常如果輸入的參數(shù)無(wú)效，格式不被支持或者由于錯(cuò)誤導(dǎo)致操I(mǎi)Exception,見(jiàn)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說(shuō)明異常如果輸入的參數(shù)無(wú)效，格式不被支持或者由于錯(cuò)誤導(dǎo)致操I(mǎi)Exception,見(jiàn)11.1說(shuō)明序列化BIR記錄，以使其作為表示CBE異常如果輸入的參數(shù)無(wú)效，格式不被支持或者由于錯(cuò)誤導(dǎo)致IException,見(jiàn)11.156.4.3.4virtualvoidDispos說(shuō)明移除當(dāng)前BIR中所有信息，清空以備下次使用異常無(wú)—UUID Path{get;};一個(gè)指向以NULL結(jié)束的字符串的指針，該字符串包含BSP可執(zhí)行代碼文件的路徑，并且包括文件名。路徑可能是URL。該字符串由GB18030中規(guī)定的字符組成，并與GB/T13000—2010的附錄D建立映射關(guān)系。當(dāng)在函數(shù)調(diào)用中使用BioAPI_BSP_ —List<RegistryID》BSPSupportedFormats( List(BSPSchemaOperations)Operations{get;}:BSP支持的生物特征識(shí)別操作列表，見(jiàn)6.7. intAdditionalDataPolicy(get;);設(shè)置的閾值(FMR最大值),用于決定驗(yàn)證成功后何時(shí)釋放—intMaxAdditionalDataSize{get intDefaultVerifyTimeout{get;}:當(dāng)應(yīng)用未規(guī)定超時(shí)時(shí)，BSP使用的用于Verify操作的默認(rèn) intDefaultIdentifyTimeout{get;}:當(dāng)應(yīng)用未規(guī)定超時(shí)時(shí)，BSP使用的用于Identify操作的默 intDefaultCaptureTimeout{get;}:當(dāng)應(yīng)用未規(guī)定超時(shí)時(shí)，BSP使用的用于Capture操作的默 intDefaultEnrolTimeo intDefaultCalibrateTimeout{get;};當(dāng)應(yīng)用未規(guī)定超時(shí)時(shí)，BSP使用的用于Calibrate操作的 intMaxBSPDbSize{get;);BSP控制的BIR數(shù)據(jù)庫(kù)的最大容量。它僅適用于BSP只能直接管6理單個(gè)存檔單元的情況。值為0表示沒(méi)有提供關(guān)于數(shù)據(jù)庫(kù)容量的信息，原因有以下3個(gè)： -intMaxIdentify{get;}:辨識(shí)函數(shù)支持的最大用戶集。如果最大用戶集沒(méi)有限制，則表示為——intMaxNumEnrolInstances{get;}:在一次注冊(cè)操作中，BSP可以的最大數(shù)量。這些信息有可能對(duì)使用應(yīng)用控制的GUI特性—byte[]HostingEndpointIRIResourceIdntifier,IRI),該框架的組件注冊(cè)表包含BSP的注冊(cè)。符合本文件的框架應(yīng)忽略該參數(shù)，應(yīng)用應(yīng)將其設(shè)置為NULL。提供它是為了支持互操作標(biāo)準(zhǔn)，這些標(biāo)準(zhǔn)可以規(guī)定在相-UUIDBSPAccessUUID{get;):一個(gè)UUID,其在應(yīng)用范圍內(nèi)是唯一的，應(yīng)用可以使用該序可以將其設(shè)置為任何UUID值。提供它是為了支持互操作標(biāo)準(zhǔn)，這些標(biāo)準(zhǔn)可以規(guī)定在相同—List<RegistryID〉BSPSupportedAlgorithms{get;}:BioAPI_ALGORITHM_ID結(jié)構(gòu)的數(shù)virtualvoidDis說(shuō)明移除當(dāng)前對(duì)象的所有信息，清空以備下次使用異常無(wú)—UUIDKey{7定義了本文件能夠使用的多個(gè)數(shù)據(jù)類型，包含枚舉和常量。本文件中未定義的常量值見(jiàn)GB/T41903.1—2022中第8章的規(guī)定。說(shuō)明使用的生物特征數(shù)據(jù)的子類型(例如指紋模態(tài)中使用的具體為/自二進(jìn)制格式時(shí)，應(yīng)使用GB/T41903.1—2022第型常量枚舉常量匯總 說(shuō)明枚舉常量匯總8(續(xù))枚舉常量匯總說(shuō)明定義訪問(wèn)數(shù)據(jù)庫(kù)的模式枚舉常量匯總——Read:只允許檢索記錄的訪問(wèn)模式；——ReadWrite:允許添加、刪除和檢索記錄的訪問(wèn)模式；——Write:允許添加和刪除記錄，但不支持檢說(shuō)明枚舉了BSP能夠提供給生物特征識(shí)別應(yīng)用的不同操作，見(jiàn)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說(shuō)明枚舉BSP可以處理的不同選項(xiàng)，見(jiàn)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說(shuō)明定義了引發(fā)事件的不同來(lái)源種類枚舉常量匯總——SourcePresent(0x00——SourceRemoved(0x0說(shuō)明定義異常事件中錯(cuò)誤的引發(fā)者，見(jiàn)11.1枚舉常量匯總——Framework:由框架組件報(bào)告錯(cuò)誤?！狟SP:由生物特征識(shí)別服務(wù)供方報(bào)告錯(cuò)誤。說(shuō)明枚舉常量匯總說(shuō)明枚舉常量匯總說(shuō)明當(dāng)調(diào)用GUI回調(diào)函數(shù)時(shí)，確定正在執(zhí)行的操作，見(jiàn)11.2枚舉常量匯總說(shuō)明在BSP發(fā)出的GUI事件通知回調(diào)將控制權(quán)返回給BSP之后，的操作，見(jiàn)11.2枚舉常量匯總說(shuō)明在一個(gè)操作中，枚舉BSP可能執(zhí)行的子操作類型，將在GUI事用程序，見(jiàn)11.2枚舉常量匯總說(shuō)明確定BIR的處理級(jí)別枚舉常量匯總說(shuō)明定義BIR或過(guò)程的目的枚舉常量匯總——EnrolForVerificat—EnrolForIdentificac說(shuō)明枚舉常量匯總—RequestAdaptedBIR:請(qǐng)求創(chuàng)建一個(gè)BIR,即通過(guò)使用輸入到生物特征驗(yàn)證中的處理過(guò)的BIR來(lái)增量更新參考模板——RequestPayload:請(qǐng)求在驗(yàn)證成功后返回Reques——RequestAdditionalData:請(qǐng)求使用附加數(shù)據(jù)，例如，在審計(jì)過(guò)程中說(shuō)明定義BioAPI_Unit支持的安全選項(xiàng)枚舉常量匯總——Encryption(Ox00000001):表示BioAPI_Unit支持加密；——MAC(0x00000002):表示BioAPI_Unit支持MAC生成；——DigitalSignature(0x00000004):表示BioAPI_Unit支持?jǐn)?shù)字簽名；——ACBioGenerationWithMAC(0x00000010):表示BioAPI_Unit支持使用MAC生成ACBio;——ACBioGenerationWithDigitalSignature(0x00000020):表示BioA說(shuō)明列出BioAPI_Unit的不同類別枚舉常量匯總——Archive:該單元管理BSP的BIR數(shù)據(jù)庫(kù)(0x00000001);——Comparison:該單元是比對(duì)算法的集合(0x00000002);——Processing:該單元是處理算法的集合(0x00000004);——Sensor:該單元管理硬件傳感器(0x00000008);——QualityAssessment:該單元是不同質(zhì)量評(píng)估過(guò)程的集合(0x00000010)說(shuō)明定義指示器狀態(tài)可能的值枚舉常量匯總說(shuō)明定義單元可能的電源模式枚舉常量匯總——Detect:當(dāng)單元能夠檢測(cè)到主體與傳感器的交互時(shí)的模式；——Normal:所有功能都可用時(shí)的模式；表示日歷日期和時(shí)間。日期和時(shí)間的編碼與CBEFF相同，并且——intDayOfMonth{get;se6.8.3.2virtualboolIsLowerOrEqual(intday,intmonth,i6.8.3.4virtualboolIsHig6.8.3.5virtualboolIsH說(shuō)明將接口中對(duì)象的日期和時(shí)間與被調(diào)用方法的參數(shù)所表示的日—IsLowerOrEqual:“參數(shù)中的日期和時(shí)間”<=“對(duì)象的日期和時(shí)間”——IsHigherOrEqual:“參數(shù)中的日期和時(shí)間”>=“對(duì)象的日期和時(shí)間”(續(xù))——day:與對(duì)象日期比較的月中某日；—month:與對(duì)象日期比較的月份；——year:與對(duì)象日期比較的年份；——hour:與對(duì)象日期比較的小時(shí)數(shù)；——minute:與對(duì)象日期比較的分鐘數(shù)；——second:與對(duì)象日期比較的秒數(shù)；異常如果輸入的參數(shù)無(wú)效，格式不支持或者由于錯(cuò)誤導(dǎo)致操作失敗ception,見(jiàn)11.1——UUIDFrameworkUUID(get;}:框架組件的UUID;——StringFwDescription{get;}:包含框架文——StringPath{get;}:一個(gè)指向以NULL結(jié)束的字符串的指針，該字符串包含框架可執(zhí)行代碼的文件的路徑，并且包括文件名。路徑可能是URL。該字符串由GB18030中規(guī)定的字符組——StringSpecVersion{get;}:實(shí)現(xiàn)框架的BioA—byte[]FwProperty{get;}:包含框架屬性的緩存區(qū)的地址和長(zhǎng)度?？蚣軐傩缘母袷胶蛢?nèi)容可virtualvoidDispose()說(shuō)明移除當(dāng)前對(duì)象的所有信息，清空以備下次使用異常無(wú)—BiometricSubtypeSu——byte[][]Pixel{get;set;說(shuō)明移除當(dāng)前對(duì)象的所有信息，清空以備下次使用異常無(wú)表示在生物特征辨識(shí)中進(jìn)行比對(duì)的BIR集合。其提供了單個(gè)屬性，即使用的用戶集的成員列表。List<PopulationMember)PopulationIdentified(get;):BSP可以使用該屬性來(lái)提供用戶集成員說(shuō)明向用于辨識(shí)目的的用戶集添加新成員。連續(xù)調(diào)用該方法以填充用戶集成員列表member:添加的成員異常如果輸入的參數(shù)無(wú)效或者由于錯(cuò)誤導(dǎo)致操作失敗，則拋出BioAPIException,見(jiàn)6.11.3.2virtualvoidDispose()說(shuō)明清空用于辨識(shí)的用戶集列表的所有信息異常BioAPIException,見(jiàn)11.1說(shuō)明說(shuō)明異常如果操作失敗，則拋出BioAPIException,見(jiàn)11.1定義了使用的數(shù)據(jù)標(biāo)識(shí)或產(chǎn)品標(biāo)識(shí)。包含在ISO/IEC19785-3和/或ISO/IEC19785-4中BIR的——shortType{get;set;}.定義了BioAPLUnit或生物特征識(shí)別應(yīng)用的加密算法和密鑰信息，這些信息用于加密/解密生物特征數(shù)據(jù)、生成/驗(yàn)證BIR的MAC或者數(shù)字簽名；也提供了哈希算法的信息、關(guān)于MAC生成的信——List(SecurityOptionsType)SupportedSecurityOptions{ge——byte[]ENCInfo{get;—byte[]MACInfo(get;);——byte[]SIGNAlg{get;):BioAPI_Unit支持的數(shù)字簽名給數(shù)字簽名算法的抽象語(yǔ)法記法一(AbstractSynt——List<BSPSchemaOptions)ACBioOption{get;}:一個(gè)掩碼，指示BioAPI_Unit支持或執(zhí)行—byte[]HASHAlgForACBio{get;—byte[]MACInfoForACBio{get;—byte[]SIGNAlgForACBio{get;}:作為SIGNAlg,但用于生成ACBio實(shí)例。virtualvoidDispose()說(shuō)明移除當(dāng)前對(duì)象的所有信息，清空以備下次使用異常無(wú)用類別和ID標(biāo)識(shí)選擇的BioAPI_Unit列表。該類的對(duì)象每個(gè)類別最多只能有一個(gè)UnitListEle-List<UnitListElement)UnitListElement《get;set;}:選擇的單元列表。說(shuō)明在所選的單元列表中添加一個(gè)新的BioAPI_Unit。如果元，則用新單元替換它unitListElement:新單元的類型和UUID的類別異常如果操作失敗，則拋出BioAPIException,見(jiàn)11.16.15.3.2intGetUnitID(UnitCategoryTypeunitCategor說(shuō)明unitCategoryType:請(qǐng)求的unitID的類別異常如果操作失敗，則拋出BioAPIException,見(jiàn)11.1。如果沒(méi)有所選類別的單元，則拋出BioAPIErrUnitCategoryNot說(shuō)明移除當(dāng)前對(duì)象的所有信息，清空以備下次使用異常無(wú)使用類別和ID標(biāo)識(shí)BioAPI_Unit。這些元素的列表用于建立在執(zhí)行聚合函數(shù)期間要考慮的單元?！猆nitCategoryTypeUnitCategory{定義生物特征識(shí)別單元的屬性。沒(méi)有方法修改已存在的UnitSchema對(duì)象?！猧ntUnitID{get;set;}:BioAPI_Un—UUIDUnitProperties(get;}:BioAPI_Unit的屬性集的UUID。屬性集可以由每個(gè)供應(yīng)商指—UUIDUnitPropertyID{get;}:下列Unit屬性結(jié)構(gòu)格式的UUID; -stringSoftwareVersion{get;}:一個(gè)包含軟件版本的以NULL結(jié)束的字符串。若無(wú)法獲結(jié)束的字符串。若無(wú)法獲結(jié)束的字符串。若無(wú)法獲 -stringHardwareSerialNumber{get;}:一個(gè)包含供應(yīng)商定義的硬件組件的唯一序列號(hào)的——boolAuthenticatedHardware{get;}:硬件組件是否經(jīng)過(guò)認(rèn)證的布爾值；——intMaxBSPDbSize{get;}:如果BioAPI_Unit為Archive單元，為單元 -intMaxldentify(get;):如果BioAPI_Unit為CvirtualvoidDispose()說(shuō)明移除當(dāng)前對(duì)象的所有信息，清空以備下次使用異常無(wú)stance。如果該單元支持ACBio,那么該單元應(yīng)使用最新生成的ACBio實(shí)例更新此字段。如果不支持ACBio,則該字段應(yīng)被固定為NULL。 保存模板的最終BIR(例如用戶生物特征參考自動(dòng)更新的情 ——byte[]AuxiliaryDat—UnitIndicatorStatusIndicatorStatus。該接口表示生物特征識(shí)別應(yīng)用或BSP的存檔功能。存檔系統(tǒng)的具體實(shí)現(xiàn)取決于開(kāi)發(fā)者(例如文件說(shuō)明關(guān)閉對(duì)開(kāi)發(fā)單元的數(shù)據(jù)庫(kù)的訪問(wèn)unitID:執(zhí)行操作的BioAPI_U異常如果操作失敗，則拋出BioAPIException,見(jiàn)11.1說(shuō)明——unitID:執(zhí)行操作的BioAPI_Unit的ID;異常拋出BioAPIException,見(jiàn)11.1說(shuō)明獲取具體記錄——unitID:執(zhí)行操作的BioAPI_Unit的ID;異常其他類型的錯(cuò)誤，則拋出BioAPIException,見(jiàn)11.1說(shuō)明unitID:執(zhí)行操作的BioAPI_U異常BioAPIException,見(jiàn)11.1說(shuō)明將BSP或BFP使用的數(shù)據(jù)庫(kù)設(shè)置為辨識(shí)操作的數(shù)據(jù)源。這也unitID:執(zhí)行操作的BioAPI_U異常BioAPIException,見(jiàn)11.1說(shuō)明將BSP或BFP使用的數(shù)據(jù)庫(kù)設(shè)置為辨識(shí)操作的數(shù)據(jù)源。這也——unitID:執(zhí)行操作的BioAPI_Unit的ID;——UUIDList:包含在新的辨識(shí)用戶異常拋出BioAPIException,見(jiàn)11.17.2.2.7IdentifyPopulationNewIdentifyPopulation(intunitID,byte[]query)說(shuō)明將BSP或BFP使用的數(shù)據(jù)庫(kù)設(shè)置為辨識(shí)操作的數(shù)據(jù)源。這也-unitID:執(zhí)行操作的BioAPI_Unit的ID;(續(xù))異常他類型的錯(cuò)誤，則拋出BioAPIException,見(jiàn)11.1說(shuō)明打開(kāi)BSP或BFP管理的數(shù)據(jù)庫(kù)。同一單元內(nèi)，不應(yīng)同時(shí)打開(kāi)其他數(shù)據(jù)庫(kù)。如果之前使用了不同的數(shù)據(jù)庫(kù)，應(yīng)在調(diào)用OpenDatabase之前調(diào)用Clos——unitID:執(zhí)行操作的BioAPI_Unit的ID;——dastabaseID:指定要打開(kāi)的數(shù)據(jù)庫(kù)的可選標(biāo)識(shí)符。當(dāng)不同的數(shù)據(jù)庫(kù)能夠與單個(gè)存檔單元一起使用時(shí)，所有數(shù)據(jù)庫(kù)應(yīng)與存檔單元的元不允許選擇不同的數(shù)據(jù)庫(kù)，那么這個(gè)參數(shù)應(yīng)有一個(gè)NULL值；-access:指定對(duì)打開(kāi)的數(shù)據(jù)庫(kù)的訪問(wèn)模式(讀/寫(xiě))異常BioAPIException,見(jiàn)11.1說(shuō)明將指定的BIR添加到無(wú)UUID的數(shù)據(jù)庫(kù)，允許單元返——unitID:執(zhí)行操作的BioAPI_Unit的ID;—biometricReference:要存異常拋出BioAPIException,見(jiàn)11.17.2.2.10voidStoreBIR(int說(shuō)明將指定的BIR添加到數(shù)據(jù)庫(kù)，并為其分配提供的UUID。如果已經(jīng)分配了UUID,則拋出異常。如果程序想要更新現(xiàn)有的UUID,應(yīng)用程序它，然后重新使用UUID。這樣做是為了避免非有意的覆蓋——unitID:執(zhí)行操作的BioAPI_Unit的ID;——biometricReference:要存儲(chǔ)的指定BIR;(續(xù))異常如果數(shù)據(jù)庫(kù)關(guān)閉，或者數(shù)據(jù)庫(kù)以只讀模式打開(kāi)，或者UUID已經(jīng)被使用了，或者任何其他類型的錯(cuò)誤，則拋出BioAPIException,見(jiàn)11.17.2.2.11UUIDStoreBIR(intunitID,BIRbiometricReference,byte[]au說(shuō)明將指定的無(wú)UUID的BIR添加到數(shù)據(jù)庫(kù)，允許單元返回分配的UUID。在AuxiliaryData(輔助數(shù)據(jù))中提交一組附加信息的字節(jié)。單元理解(未在本文件規(guī)定)。例如，這些信息可以是—unitID:執(zhí)行操作的BioAPI_Unit的ID;——biometricReference:要存儲(chǔ)的指定的BIR;——auxiliaryData:存儲(chǔ)到數(shù)據(jù)庫(kù)的，與所存儲(chǔ)的BI異常拋出BioAPIException,見(jiàn)11.17.2.2.12voidStoreBIR(intunitID,BIRbiometricReference,byte[]auxiliaryData,UUIDkey)說(shuō)明將指定的BIR添加到數(shù)據(jù)庫(kù)，并為其分配提供的UUID。如果已經(jīng)分配了UUID,則拋出異常。如果程序想要更新現(xiàn)有的UUID,應(yīng)用程序它，然后重新使用UUID。這樣做是為了避免非有意的覆蓋。在AuxiliaryData(輔助數(shù)據(jù))中提——unitID:執(zhí)行操作的BioAPI_Unit的ID;——biometricReference:要存儲(chǔ)的指定的BIR;——auxiliaryData:存儲(chǔ)到數(shù)據(jù)庫(kù)的，與所存儲(chǔ)的BIR相關(guān)的附加數(shù)據(jù)；異常如果數(shù)據(jù)庫(kù)關(guān)閉，或者數(shù)據(jù)庫(kù)以只讀模式打開(kāi)，或者UUID已經(jīng)在使用中了，或者任何其他類型的錯(cuò)誤，則拋出BioAPIException,見(jiàn)11.1該接口包含執(zhí)行生物特征比對(duì)功能所需的所有屬性和方法。定義了一些屬性來(lái)返回Verify方法在該單元中，使用了FMR術(shù)語(yǔ)。FMR將誤匹配率表示為一個(gè)32bit(比特)的整數(shù)值(N),表示可說(shuō)明unitID:執(zhí)行操作的BioAPI_U異常如果出現(xiàn)任何錯(cuò)誤，則拋出BioAPIException,見(jiàn)11.1說(shuō)明獲取先前比對(duì)中獲得的FMR值unitID;執(zhí)行操作的BioAPIU獲得的FMR值異常如果出現(xiàn)任何錯(cuò)誤，則拋出BioAPIException,見(jiàn)11.17.3.2.3List<Candidate)Identify(intunitID,intbinning,intmaxResults,intauxiliaryBIRs,boolbinning,intmaxResult說(shuō)明PresetIdentifyPopulation提前確定。為了更好地適應(yīng)比對(duì)算法，定義了重載方法，以(續(xù))——unitID:執(zhí)行操作的BioAPIUnit的ID;——maxFMRrequested:成功辨識(shí)所要求的FMR標(biāo)準(zhǔn)(即；比對(duì)閾值)——processedBIR:待辨識(shí)的—auxiliaryBIRs:可選項(xiàng)，用于提高比對(duì)算法性能的輔助BI——binning:表明分箱是否運(yùn)行或關(guān)閉的布爾搜索技術(shù)。根據(jù)生物特征數(shù)據(jù)的固有特性，它基于用戶集的子集進(jìn)行搜索這樣雖然能夠提高比對(duì)操作的速度，但也增加了漏掉某些候選者的可能性(由匹配的BIR的分箱的情況);—timeout:表示操作超時(shí)的整數(shù)值(以毫秒為單位)。如果達(dá)出異常。這個(gè)值可以是任何正數(shù)。“一1”表示要使用BSP默認(rèn)超時(shí)值異常如果輸入的參數(shù)無(wú)效，或者由于錯(cuò)誤導(dǎo)致操作失敗，則拋出BioAPIException,見(jiàn)7.3.2.5voidPresetIdentifyPopulation(intunitID,Identifypopu說(shuō)明向比對(duì)單元提供BIR用戶集。成功調(diào)用此方法后，BSP可以調(diào)用Identify()。B或會(huì)話終止——unitID:執(zhí)行操作的BioAPI異常如果輸入的參數(shù)無(wú)效，或者由于錯(cuò)誤導(dǎo)致操作失敗，則拋出BioAPIException,見(jiàn)說(shuō)明對(duì)現(xiàn)有的生物特征樣本進(jìn)行生物特征驗(yàn)證。該函數(shù)在兩個(gè)BIR特征參考)之間執(zhí)行驗(yàn)證(一對(duì)一)比對(duì)。輸入BIR是專門(mén)為驗(yàn)證而構(gòu)造的經(jīng)過(guò)處理的BIR。參考模板是在注冊(cè)時(shí)創(chuàng)建的。應(yīng)用應(yīng)為成值標(biāo)準(zhǔn)(閾值)該方法的布爾輸出表示驗(yàn)證是否成功，以及內(nèi)部屬性(FMRAchiev和AdditionalData)是否被更新。通過(guò)設(shè)置RequestAdapted求通過(guò)使用輸入的處理過(guò)的BIR更新參考模板來(lái)構(gòu)造BIR,如果比對(duì)成功，可以嘗試使用輸入BIR的信息來(lái)更新執(zhí)行更新操作)。最終得到的、經(jīng)過(guò)更新的BIR,宜被認(rèn)為是是或丟棄這些數(shù)據(jù)取決于應(yīng)用)。需要注意的是，更如果additionalData與參考模板相關(guān)，并且達(dá)到的FMR足夠嚴(yán)格，則在驗(yàn)證成功后可返回additionalData:這由BSP的策略控制，并在其模式中規(guī)定。通過(guò)設(shè)置RequestAdditionalData選項(xiàng)，請(qǐng)求返回additionalData。該接口的Get函數(shù)提供了對(duì)結(jié)果的不同訪問(wèn)方式。該方法被一個(gè)附加參數(shù)重載，該參數(shù)聲明一個(gè)輔助B—unitID:執(zhí)行操作的BioAPI——maxFMRrequested:比對(duì)閾值；——processdBIR:待辨識(shí)的BIR,見(jiàn)6.4;—auxiliaryBIRs:可選項(xiàng)，用于提高比對(duì)算法性能的輔——referenceTemplate:用于驗(yàn)證的參考——Options:請(qǐng)求附加輸出，例如更新的BIR和/或additio表示生物特征驗(yàn)證操作結(jié)果的布爾判定異常如果輸入的參數(shù)無(wú)效，或者由于錯(cuò)誤導(dǎo)致操作失敗，則拋出BioAPIException,見(jiàn)7.4.2.1BIRCreateTemplate(intunitID,BFormat,byte[]addition7.4.2.2BIRCreateTemplate(intunitID,List<BIR)capturedBIRs,BIRreoutputFormat,byte[]addit說(shuō)明獲取包含生物特征數(shù)據(jù)的BIR或BIR列表，用于創(chuàng)建以從采集的BIR構(gòu)造，也可以基于現(xiàn)有的參考模板進(jìn)行更新。如果BSP支持此功能，則提供可選的輸入?yún)⒖寄０逵糜趧?chuàng)建新模板——unitID:執(zhí)行操作的BioAPIUnit的ID;——capturedBIR:采集的BIR,見(jiàn)6.4;—capturedBIRs;采集的BIR列表，見(jiàn)6.4;——referenceTemplate:可選項(xiàng)，待更新的已存在——outputFormat;如果BSP支持多種格式，則指定返回的已處理過(guò)的BIR使用哪種BDB格式。NULL值表示BSP要選擇格式，見(jiàn)6.13——additionalData:BSP將要存儲(chǔ)的additi異常如果輸入的參數(shù)無(wú)效，格式不支持或者由于錯(cuò)誤導(dǎo)致操作失敗ception,見(jiàn)11.7.4.2.3BIRProcess(intunitID,BIRcap說(shuō)明——unitID:執(zhí)行操作的BioAPIU——capturedBIR:采集的BIR,見(jiàn)6.4;——auxiliaryBIR:操作中使用的包含輔助數(shù)據(jù)的BIR,見(jiàn)6.4, —outputFormat:如果BSP支持多種格式，則指定返回的已處理過(guò)的BIR使用哪種BDB格式。NULL值表示BSP要選擇格式。見(jiàn)6.13異常7.4.2.5byteAnalyseQuality(intunitID說(shuō)明處理采集的生物特征樣本，以分析其質(zhì)量并返回一個(gè)質(zhì)量得分——unitID:執(zhí)行操作的BioAPI_Unit的ID;質(zhì)量得分，可以是0(最低質(zhì)量)到100(最高質(zhì)量)之間的異常如果輸入的參數(shù)無(wú)效，或者由于錯(cuò)誤導(dǎo)致操作失敗，則拋出BioAPIException,見(jiàn)說(shuō)明如果傳感器支持，則對(duì)傳感器進(jìn)行校準(zhǔn)—unitID:執(zhí)行操作的BioAPI_Unit的ID;異常如果輸入的參數(shù)無(wú)效，或者由于錯(cuò)誤導(dǎo)致操作失敗，則拋出BioAPIException,見(jiàn)7.5.2.2BIRCapture(intunitID,List《PurpoputFormat,inttimeout,List<ResultOptions)說(shuō)明采集BIR的數(shù)據(jù)頭。如果指定了RequestAuditData選項(xiàng)，則可以在CaptureResult中返回原始類型的BIR(續(xù))——unitID:執(zhí)行操作的BioAPIUnit的ID;——purpose:表示采集生物特征數(shù)據(jù)的目的——subtype:表示采集的生物特征樣本的子類型。NULL表示6.7.2.1;-outputFormat:如果BSP支持多種格式，則指定返回的、已處理的BIR使用哪種BDB格式。NULL表示BSP要選擇格式。見(jiàn)6.13——timeout:表示操作超時(shí)值的整數(shù)值(以毫秒為單位)表示采集操作結(jié)果的BIR對(duì)象(見(jiàn)6.4)異常如果傳感器設(shè)備正被占用，或者操作失敗，則拋出BioAPIException,見(jiàn)11.說(shuō)明獲取指示器當(dāng)前狀態(tài)的函數(shù)unitID:執(zhí)行操作的BioAPIU異常如果出現(xiàn)任何錯(cuò)誤，則拋出BioAPIException,見(jiàn)11.1說(shuō)明如果BioAPIUnit支持，則該函數(shù)將所選的BioAPIU狀態(tài)。在IndicatorStatus參數(shù)中設(shè)置Accept或Reiect之后，直到應(yīng)用——unitID:執(zhí)行操作的BioAPIU——indicatorStatus;設(shè)置BioAPIUnit指示器狀態(tài)的值異常如果出現(xiàn)任何錯(cuò)誤，則拋出BioAPIException,見(jiàn)11.1表示生物特征識(shí)別功能供方。該接口由BFP功能和BFP支持的BioAPI_Unit的集合組成。在同——BFPSchemaBFPSchema{get;set;};——byte[]ACBioInstance{get;——BFPGUIProgressCallbackBFPGUICallback事件。8.5.2voidBFPLoad(BFPEventCallb說(shuō)明初始化BFP。初始化包括為指定的BFP注冊(cè)BSP事件句柄并激活所有事件。BSP可以選擇提供一個(gè)事件句柄函數(shù)來(lái)接收事件通知。許多BSP可以發(fā)地加載相同的BFP,并且每個(gè)BSP可以建立自己的事件句柄。它們都將收到事件通知。如果一個(gè)BSP加載多個(gè)BFP,則可以使用相同或不同的事件句柄。通過(guò)一次或多次調(diào)用BFPLoad,BSP可以為指定的BFP建立任意數(shù)量的事件句當(dāng)事件在BFP中發(fā)生時(shí)，BFP可以通過(guò)調(diào)用BSP的事件句柄向BSP如果BSP已經(jīng)設(shè)置了多個(gè)事件句柄，則應(yīng)按BFP選擇的任意順序一次調(diào)用一個(gè)事件通知可以在任何時(shí)候發(fā)生，無(wú)論是在BSP調(diào)用期間(與是在執(zhí)行時(shí)沒(méi)有BSP調(diào)用時(shí)。無(wú)論BSP何時(shí)接收回調(diào)，BSP開(kāi)發(fā)者宜確保所有回當(dāng)加載BFP(BFPLoad)時(shí)，它應(yīng)立即為每個(gè)當(dāng)前的BioAPI_Unit引發(fā)一個(gè)“插入”入”事件。BFPNotifyCallback定義一個(gè)回調(diào)函數(shù)，用于向BSP通知BioAPI_EVE事件。BFP應(yīng)保留此信息以備后續(xù)使用(續(xù))bfpNotifyCallback:定義一個(gè)回調(diào)，用于向BioAP異常如果任何參數(shù)無(wú)效或者初始化過(guò)程中出現(xiàn)任何其他錯(cuò)誤，則拋出BioAPIException,見(jiàn)11.1說(shuō)明禁用事件并注銷當(dāng)前已與BSP創(chuàng)建鏈接的BFP的使用異常如果任何參數(shù)無(wú)效或者初始化過(guò)程中出現(xiàn)任何其他錯(cuò)誤，則拋出BioAPIException,見(jiàn)11.18.5.4byte[]ControlUnit(intunitID,intcontrolCode,byte[]inputDa說(shuō)明向BioAPI_Unit發(fā)送控制數(shù)據(jù)并從那里接收狀態(tài)或操作數(shù)據(jù)。參數(shù)和輸出的內(nèi)容將在BioAPI_Unit的相關(guān)接口規(guī)范中指定。層上需要，因此這些相關(guān)內(nèi)部方法調(diào)用的方式依賴于實(shí)現(xiàn)，這超出了本文件的范圍——unitID:執(zhí)行操作的BioAPI_Unit的ID;—controlCode:在BioAPI_Unit中被調(diào)用的函數(shù)編碼；——inputData:包含將被發(fā)送到BioAPI_Unit的，與給定的ControlCode相關(guān)的數(shù)據(jù)的緩存區(qū)包含在處理了ControlCode所指示的函數(shù)之后，從BioAPI_Un異常如果出現(xiàn)任何錯(cuò)誤，則拋出BioAPIException,見(jiàn)11.1說(shuō)明執(zhí)行操作后，從引用的BioAPI_Unit(如傳感器)獲得任何可用的輔助數(shù)據(jù)。unitID:執(zhí)行操作的BioAPI_U在處理完前面的函數(shù)后，包含從BioAPI_Unit接收到的輔助數(shù)據(jù)的數(shù)據(jù)緩存異常如果出現(xiàn)任何錯(cuò)誤，則拋出BioAPIException,見(jiàn)11.1見(jiàn)8.5.7。8.5.7List<UnitSchema)QueryUnits(List<UnitCategoryType)unitCategories)說(shuō)明該函數(shù)返回由給定的BFP管理的，并且當(dāng)前處于插入狀態(tài)的BioAPI_Unit模式列表。BFP中的所有單元應(yīng)有定義的UnitSchema。對(duì)于給定的BioAPIUnit,不要求該函數(shù)返回的單元ID由BS值提供給框架。BSP可以自由地將BFP提供的任何單元IID值，然后再提供給框架。這種轉(zhuǎn)換的目的是避免在BSP的范圍內(nèi)存在重復(fù)的單元ID。當(dāng)BSP使用兩個(gè)或更多相同類別的BFP;或者(BFP中的傳感器單元),與此同時(shí)直接管理生物特征傳感器時(shí)，重復(fù)可能發(fā)生UnitSchema列表，其中每個(gè)元素描述當(dāng)前會(huì)話中每個(gè)可用異常如果無(wú)法訪問(wèn)BFP,則在調(diào)用該方法時(shí)拋出BioAPIException,見(jiàn)11.18.5.8voidSetPowerMode(intunitID,Un說(shuō)明如果BioAPIUnit支持，該函數(shù)將加載的BSP所引用的Bio的電源模式——unitID:執(zhí)行操作的BioAPIUnit的ID;——poewrMode:設(shè)置BioAPI_Unit的異常如果出現(xiàn)任何錯(cuò)誤，則拋出BioAPIException,見(jiàn)11.1表示生物特征識(shí)別服務(wù)供方。它是會(huì)話對(duì)象的工廠，提供對(duì)生物特征識(shí)別操作的訪問(wèn)。該接口由BSP的功能和BSP支持的BioAPI_Unit的集合組成。它還可以支持與BFP和組件注冊(cè)表的通信。BSP開(kāi)發(fā)者可以決定不向外界提供所支持的BioAPI_Unit的某些功能的調(diào)用，而是發(fā)起一個(gè)Bio-APIException,表明不支持這樣的方法。此外，通過(guò)繼承IBSPUnitSet接口添加與框架交互所需的方法和屬性。 byte[]ACBioInstance{geBSPEventCallbackB9.5.2voidBSPLoad(BSPEventCallbackbspNotifyCallback,B說(shuō)明初始化BSP。如果沒(méi)有對(duì)BSPUnload()的——bspNotifyCallback;定義用于將事件通知BioAPI框架的回調(diào)——bfpEnumerationCallb知道在生物識(shí)別系統(tǒng)中安裝了哪些BFP異常如果任何參數(shù)無(wú)效，或初始化過(guò)程中出現(xiàn)任何其他錯(cuò)誤，則拋出BioAPIException,見(jiàn)11.1說(shuō)明禁用事件并在應(yīng)用中注銷當(dāng)前BSP的使用異常如果任何參數(shù)無(wú)效，或初始化過(guò)程中出現(xiàn)任何其他錯(cuò)誤，則拋出BioAPIException,見(jiàn)11.19.5.4byteCheckQuality(BIRinp說(shuō)明該函數(shù)對(duì)包含在輸入BIR中的生物特征數(shù)據(jù)進(jìn)行質(zhì)量評(píng)價(jià)。如果指定了質(zhì)量算法，并且BSP支持該算法，則應(yīng)使用該算法。如果為NULL,則BSP將選擇要應(yīng)用的質(zhì)量算法。BSP可以通過(guò)調(diào)用BioAPIEnumBSP持哪些質(zhì)量算法。如果請(qǐng)求的是不支持的算法，則應(yīng)拋出BioAPIERR_PORTED_ALGORITHMBioAPIExc——inputBIR:包含需要評(píng)價(jià)質(zhì)量的生物特征數(shù)據(jù)的BIR; 異常如果有任何錯(cuò)誤，則拋出BioAPIException,見(jiàn)11.19.5.5byte[]ControlUnit(intunitID,intcontrolCode,byte[]inputData)說(shuō)明將控制數(shù)據(jù)發(fā)送給BioAPIUnit,并從那里接收狀態(tài)或操作數(shù)據(jù)。參數(shù)和輸出的內(nèi)容將在BioAPI_Unit相關(guān)的接口規(guī)范中指定?！猽nitID:執(zhí)行操作的BioAPI——controlCode:被調(diào)用的BioAPI_Unit中的函數(shù)編碼；——inputData:包含要發(fā)送到BioAPI_Unit的，與給定的ControlCode相關(guān)的數(shù)據(jù)的緩存區(qū)包含在處理了ControlCode所指示的函數(shù)后，從BioAPIUni異常如果有任何錯(cuò)誤，則拋出BioAPIException,見(jiàn)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說(shuō)明按照上述列表中出現(xiàn)的順序，通過(guò)下列方法注冊(cè)用戶—在該方法的第一個(gè)參數(shù)中提供用于注冊(cè)的樣本；——在該方法的第一個(gè)參數(shù)中提供用于注冊(cè)的樣本列表；——要求BSP中的傳感器單元進(jìn)行一定次數(shù)的采集。注冊(cè)可以從頭開(kāi)始，或者更新先前的注冊(cè)。在第一種情況下，參數(shù)Replate或ReferenceID應(yīng)是NULL。在第二種情況下，可以通過(guò)BIR(使用Referen-ceTemplate)或UUID(使用ReferenceID)提供要更新的生物成功注冊(cè)的結(jié)果；給創(chuàng)建的生物特征參考分配的UUID,以及該生物特征參考的BIR(可選),它將位于BiometricReference屬性中。如果出于任何原因考慮),BSP不想發(fā)布生成的生物特征參考，則該屬性應(yīng)設(shè)置為NULL,BSP負(fù)責(zé)提供與注冊(cè)操作相關(guān)的默認(rèn)用戶接口。應(yīng)用可以通過(guò)BSP.Subscribe-ToGUIEvents()方法提供GUI回調(diào)請(qǐng)求對(duì)GUI“外觀”的控制。由于E作包括采集，所以它序列化了傳感器設(shè)備的使用。如果有兩個(gè)或兩個(gè)以上應(yīng)用在爭(zhēng)用該設(shè)備，則失敗的應(yīng)用將等待操作完成或超時(shí)過(guò)期。這種序列化發(fā)生在所有采集數(shù)據(jù)的函數(shù)中。BSP負(fù)責(zé)序列化。它可以通過(guò)拋出異常來(lái)表明設(shè)備正忙，或者通過(guò)排隊(duì)請(qǐng)求來(lái)實(shí)現(xiàn)這一點(diǎn)(續(xù))——unitList:執(zhí)行操作的BioAPI_Unit;—capturedBIR:可選項(xiàng)，用于注冊(cè)的BIR格式的生物特征樣本，見(jiàn)6.4;capturedBIRs:可選項(xiàng)，用于注冊(cè)的生物特征樣本的BIR列表，見(jiàn)6.4;numberOfPresentations:當(dāng)注冊(cè)樣本在BSP內(nèi)采集時(shí)，該得的樣本數(shù)量；numberOfAttempts:在返回一個(gè)注冊(cè)失敗(FTE)異常之前一個(gè)呈現(xiàn)(presentation)應(yīng)進(jìn)行的最大嘗試次數(shù)——referenceTemplate:可選項(xiàng)，將被更新的生物特征參考的BIR,見(jiàn)6.4;——referenceID:可選項(xiàng)，將被更新的生物特征參考的UUID;ficationonly)的值；——subtype:表示注冊(cè)的子類型(例如左/右眼)。NULL值表示類型，見(jiàn)6.7.2.1;outputFormat:如果BSP支持多種格式，該參數(shù)規(guī)定返回的N用哪種BDB格式。NULL值表示BSP要選擇格式，見(jiàn)6.13——additionalData:BSP將要存儲(chǔ)的additionalData;—timeout:表示操作超時(shí)值的整數(shù)值(以毫秒為單位),如果達(dá)到此超時(shí)值，函表示將使用BSP默認(rèn)超時(shí)值；options:請(qǐng)求附加輸出，例如審計(jì)數(shù)據(jù)。這些數(shù)據(jù)供與人相關(guān)的人類可識(shí)別的數(shù)據(jù)異常如果參數(shù)錯(cuò)誤，或者在處理過(guò)程中出現(xiàn)其他錯(cuò)誤(例如不能訪問(wèn)數(shù)據(jù)庫(kù)),則拋出BioAPIException,見(jiàn)11.1說(shuō)明在執(zhí)行操作后，從引用的BioAPI_Unit(如傳感器)獲取任何可用的輔助數(shù)據(jù)。unitID:執(zhí)行操作的BioAPI_異常如果出現(xiàn)任何錯(cuò)誤，則拋出BioAPIException,見(jiàn)11.19.5.13List(Candidate)IdentifyAggregated(UnitLisBiometricSubtypesubtype,boolbinning,intmaxResults,inttimeout,List(ResultOptions)options)說(shuō)明該方法提供了聚合功能。它增加了IComparison(見(jiàn)7.3)中的Identify方法的功能。當(dāng)BSP調(diào)用自己的傳感器單元直接采集生物特征樣本時(shí)，或者通過(guò)以原始的或處理過(guò)的格式提供輸入BIR時(shí)，它允許進(jìn)行辨識(shí)操BSP負(fù)責(zé)提供與注冊(cè)操作相關(guān)的默認(rèn)用戶接口。應(yīng)用程序可以通過(guò)BSP.SubbeToGUIEvents()方法提供GUI回調(diào)來(lái)請(qǐng)求對(duì)GUI“外觀”的控制作包括采集，所以它序列化了傳感器設(shè)備的使用。如果有兩個(gè)或兩個(gè)以上應(yīng)用在爭(zhēng)用該設(shè)備，則失敗的應(yīng)用將等待操作完成或超時(shí)過(guò)期。這種序列化發(fā)生在所有采集數(shù)據(jù)的函數(shù)中。BSP負(fù)責(zé)序列化。它可以通過(guò)拋出異常來(lái)表明設(shè)備正忙，或者通過(guò)排隊(duì)請(qǐng)求來(lái)實(shí)現(xiàn)這一點(diǎn)—unitList:執(zhí)行操作的BioAPIUnit——timeout:表示操作超時(shí)值的整數(shù)值(以親秒為單位)。如果達(dá)到此超時(shí)值，則拋出異常。這個(gè)值可以是任何正數(shù)。“一1”表示將使用BSP默認(rèn)超時(shí)值；-options:請(qǐng)求附加輸出，例如審計(jì)數(shù)其他參數(shù)見(jiàn)IComparison(7.3)中異常如果出現(xiàn)任何Capture異常(7.5)或者Identify異常(7.3),則拋出BioAPIException,見(jiàn)11.1說(shuō)明返回當(dāng)前會(huì)話中BSP支持的可用的BFP的標(biāo)unitCategories:可選項(xiàng)，請(qǐng)求枚舉的單元模當(dāng)前BSP支持的BFP列表異常BioAPIException,見(jiàn)11.19.5.18List<UnitSchema)QueryUnits(List《UnitCategoryType)unitCategories)說(shuō)明BSP返回可用的單元。BSP中的所有單元應(yīng)有一個(gè)定義的UnitSunitCategories:可選項(xiàng)，請(qǐng)求枚舉的單元模UnitSchemas列表，其每個(gè)元素描述了每個(gè)可用異常如果在BSP被卸載后調(diào)用該方法，則拋出BioAPIException,見(jiàn)11.1metricSubtypesubtype,inttimeout,Li9.5.20boolVerifyAggregated(UnitListunitList,ienceKey,BiometricSubtypesu說(shuō)明該方法提供聚合功能。它從IComparison(見(jiàn)7.3)中增加了Verify方法的功能，允——BSP通過(guò)調(diào)用自己的傳感器單元直接采集生物特征樣本。因——以原始或處理過(guò)的格式提供生物特征樣本—由其UUID聲明生物特征參考。因此，增加了refere——提供作為BIR的生物特征參考。因此，使用了referenceTe——BSP本質(zhì)上知道生物特征參考(例如單個(gè)用戶、單個(gè)注冊(cè)應(yīng)用)。因此，調(diào)用將以NULL作為referenceTemplate或referenceKey。進(jìn)一步的說(shuō)明見(jiàn)IComparison(7.3)中的VeriBSP負(fù)責(zé)提供與注冊(cè)操作相關(guān)的默認(rèn)用戶接口。應(yīng)用程序可以通過(guò)BSP.SubbeToGUIEvents()方法提供GUI回調(diào)來(lái)請(qǐng)求對(duì)GUI“外觀”的控制作包括采集，所以它序列化了傳感器設(shè)備的使用。如果有兩個(gè)或兩個(gè)以上應(yīng)用在爭(zhēng)用該設(shè)備，則失敗的應(yīng)用將等待操作完成或超時(shí)過(guò)期。這種序列化發(fā)生在所有采集數(shù)據(jù)的函數(shù)中。BSP負(fù)責(zé)序列化。它可以通過(guò)拋出異常者通過(guò)排隊(duì)請(qǐng)求來(lái)實(shí)現(xiàn)這一點(diǎn)(續(xù))——unitList:執(zhí)行操作的BioAPI_Unit;——referenceKey:用于驗(yàn)證的生物特征參考的UUID;——referenceTemplate;與用于驗(yàn)證的生物特征參——subtype;規(guī)定采集的子類型(例如左/右眼)。NULL值表示沒(méi)有提供該值，見(jiàn)6.7.2.1;——timeout;表示操作超時(shí)值的整數(shù)值(以毫秒為單位)。如果達(dá)到此超時(shí)值，則拋出異常。這個(gè)值可以是任何正數(shù)?！耙?”表示將 其他參數(shù)見(jiàn)IComparison(7.3異常如果出現(xiàn)任何Capture異常(7.5)或者Verify異常(7.3),則拋出BioAPIException,見(jiàn)11.19.5.23voidSetPowerMod說(shuō)明如果BioAPI_Unit支持，該函數(shù)將加載的BSP中所引用的Bi—unitID:執(zhí)行操作的BioAPIUnit的ID;——powerMode:設(shè)置BioAPI_Unit異常如果出現(xiàn)任何錯(cuò)誤，則拋出BioAPIException,見(jiàn)11.1說(shuō)明該方法為BSP提供Select,State和Progress事件的事件，則應(yīng)為該類事件提供NULL值。如果將三個(gè)事件都設(shè)置能調(diào)用該方法。如果該方法是用先前已經(jīng)分配回調(diào)函數(shù)的確定事件調(diào)用，則該方法只需簡(jiǎn)單的用當(dāng)前調(diào)用中提供的回調(diào)地址替換舊的回調(diào)地址—guiSelectEventCallbackFunction:為SelectEvent的回調(diào)函數(shù)指定地址；——guiStateEventCallbackFunction:為StateEvent的回調(diào)函數(shù)指定地址guiPtogressEventCallbackFunction;為ProgressEvent的回調(diào)函數(shù)指定地址異常BioAPIException,見(jiàn)11.1說(shuō)明該方法清除之前訂閱的回調(diào)地址。調(diào)用該函數(shù)后，BSP應(yīng)停止向框架或應(yīng)用通知異常BioAPIException,見(jiàn)11.1說(shuō)明在組件注冊(cè)表中安裝或更新對(duì)BFP的引用。該函數(shù)在BioAP——bfpSchema:指定要安裝或更新的BFP的信息 回ERR_COMPONENT_NOT_REGISTEREDBioAPIException)。如果為假，則安裝一個(gè)新BFP。如果已經(jīng)安裝了BFP,則拋出ERRALREADY_REGISTEREDBioAPIExcept異常如果在安裝過(guò)程中出現(xiàn)任何錯(cuò)誤，則拋出BioAPIException,見(jiàn)11.1說(shuō)明參數(shù)——bspSchema:指定要安裝或更新的BSP的信息；回ERR_COMPONENT_NOT_REGISTEREDBioAPIException)。如果為假，則安裝一個(gè)新BSP。如果已經(jīng)安裝了BSP,則拋出ERRALREADYREGISTEREDBioAPIExcept異常如果在安裝過(guò)程中出現(xiàn)任何錯(cuò)誤，則拋出BioAPIException,見(jiàn)11.110.1.2.3voidUninstallBFP(UUID說(shuō)明異常如果出現(xiàn)任何錯(cuò)誤，則拋出BioAPIException,見(jiàn)11.說(shuō)明異常如果出現(xiàn)任何錯(cuò)誤，則拋出BioAPIException,見(jiàn)11.1表示生物特征識(shí)別系統(tǒng)。生物特征識(shí)別系統(tǒng)是一個(gè)層次結(jié)構(gòu)系統(tǒng)，其根節(jié)點(diǎn)及管理傳感器硬件的代碼。除了BSP,框架的另一部分是組件注冊(cè)表，它存儲(chǔ)關(guān)于BSP和BFP的FrameworkSchemaFrameworkSchema{get;}。說(shuō)明收到事件通知。如果應(yīng)用加載了多個(gè)BSP,那么可以使用相同或不同的事件句柄對(duì)于給定的BSP,應(yīng)用可以通過(guò)一次或多次調(diào)用BioAPI_BSPLo立任意多的事件句柄。事件句柄由地址和上下文的當(dāng)BSP中發(fā)生事件時(shí)，該BSP可以通過(guò)調(diào)用框架的事件句柄向框架發(fā)送事件當(dāng)框架接收到來(lái)自BSP的事件通知時(shí)，它應(yīng)給每個(gè)應(yīng)用創(chuàng)建的每個(gè)事件句柄發(fā)送一個(gè)通知，表明為該BSP啟用了事件通知。因此，從BSP到框架的單一事件通知回調(diào)，可導(dǎo)致從框架到零個(gè)或多個(gè)應(yīng)用的零當(dāng)框架接收到來(lái)自BSP的事件通知時(shí)，它應(yīng)調(diào)用每個(gè)應(yīng)用為該BSP所建立的全部事件句柄。如果應(yīng)用建立了多個(gè)事件句柄，則應(yīng)按照框架個(gè)句柄，而不是同時(shí)調(diào)用，事件通知可能在任何時(shí)刻發(fā)生，或者在BioAPI調(diào)用期間(與事件相關(guān)或無(wú)關(guān)),或者在沒(méi)有執(zhí)行BioAPI調(diào)用時(shí)。無(wú)論應(yīng)用何時(shí)接收這些回調(diào)，應(yīng)用開(kāi)發(fā)者都宜確別的每個(gè)可用BioAPIUnit的“插入”事件通知。如果生物特征識(shí)別應(yīng)用已經(jīng)在BSPLoad的調(diào)用中提供了一個(gè)事件句柄，并且還沒(méi)有禁用“插入”事件通知，那么框架將依次回調(diào)應(yīng)用的事件句柄。可以通過(guò)調(diào)用EnableEventNot定功能的硬件組件，則在插入硬件組件之前無(wú)法引發(fā)“插入”事件。只有當(dāng)至少有一次對(duì)Init的調(diào)用且尚未進(jìn)行相應(yīng)的Terminate調(diào)用時(shí)，才會(huì)除非使用InstallBSP安裝了BSP,否則不應(yīng)調(diào)用BSPLoad函數(shù)。通過(guò)調(diào)用——bspID;標(biāo)識(shí)要初始化的BSP;—notifyCallback:調(diào)用方提供的事件通知函數(shù)。定義了來(lái)自加載的生物特征識(shí)別服務(wù)供方的事件通知的回調(diào)；——bfpEnumerationCallback:調(diào)用方提供的事件通知函數(shù)?；?context:上下文信息的通用指針。當(dāng)所選的生物特征識(shí)別時(shí)，將此值作為輸入傳遞給NotifyCallback指定的事件句柄異常如果框架被終止或者出現(xiàn)任何其他錯(cuò)誤，則拋出BioAPIException,見(jiàn)11.1說(shuō)明為BSPUUID標(biāo)識(shí)的調(diào)用方注銷事件通知回調(diào)，對(duì)bspUnload的調(diào)用與對(duì)bspLoad的調(diào)用類似。如果向BioAPI注冊(cè)的所有回調(diào)被移除，那么BioAPI將為該生物特征識(shí)別應(yīng)用卸載通過(guò)調(diào)的BSP。BioAPI框架使用三個(gè)輸入?yún)?shù)來(lái)唯一標(biāo)識(shí)已注冊(cè)的回調(diào)對(duì)于給定的BSPUUID,僅在至少有一次對(duì)BSPLoad的調(diào)用這包括BioAPI框架在terminate調(diào)用期間隱式地執(zhí)行與缺少對(duì)——bspID:標(biāo)識(shí)要初始化的BSP; context;上下文信息的通用指針。當(dāng)所選的生物特征識(shí)別服務(wù)供方引發(fā)事件時(shí)，將此值作為輸入傳遞給NotifyCallback指定的事件句柄異常如果框架被終止或者出現(xiàn)任何其他錯(cuò)誤，則拋出BioAPIException,見(jiàn)11.110.2.4.3voidEnableEventNotifications(UUID說(shuō)明啟用Events參數(shù)標(biāo)識(shí)的，并且來(lái)自于BSPUUID標(biāo)識(shí)的BSP的事件，并禁用來(lái)自僅對(duì)調(diào)用該函數(shù)的應(yīng)用啟用或禁用事件。如果有其他應(yīng)用同時(shí)使用架或指定的BSP,這些應(yīng)用將不會(huì)受到調(diào)用enableEventNotification的影響該函數(shù)可以在BioAPIInit之后的任何時(shí)候調(diào)用，甚至在加載指定的BSP之前。對(duì)該函數(shù)的調(diào)用所建立的事件參數(shù)將一直有效，直到相同的B只有當(dāng)至少有一次對(duì)Init的調(diào)用且尚未進(jìn)行相應(yīng)的Terminate調(diào)用時(shí)，才會(huì)調(diào)用異常如果框架已終止或者出現(xiàn)任何其他錯(cuò)誤，則拋出BioAPIException,見(jiàn)11.1說(shuō)明該函數(shù)提供組件注冊(cè)表中現(xiàn)已安裝的所有BFP的信息只有當(dāng)至少有一次對(duì)Init的調(diào)用且尚未進(jìn)行相應(yīng)的Terminate調(diào)用時(shí)，才會(huì)調(diào)用(續(xù))系統(tǒng)中可用的BFP的BFPSchema列表異常如果在框架終止后調(diào)用該方法，則拋出BioAPIException,見(jiàn)11.1說(shuō)明該函數(shù)提供組件注冊(cè)表中現(xiàn)已安裝的所有BSP的信息。它使用所有已安裝的只有當(dāng)至少有一次對(duì)Init的調(diào)用且尚未進(jìn)行相應(yīng)的Terminate調(diào)用時(shí)，才會(huì)調(diào)用BSPSchemas列表，其每個(gè)元素描述了生物特征識(shí)別系統(tǒng)中一個(gè)可用異常如果在框架終止后調(diào)用該方法或出現(xiàn)任何其他錯(cuò)誤，則拋出BioAPIException,見(jiàn)說(shuō)明初始化BioAPI框架，并驗(yàn)證應(yīng)用預(yù)期的BioAPI框架的版本與API框架版本是否兼容。應(yīng)用應(yīng)至少調(diào)用一次version:與生物特征識(shí)別應(yīng)用相兼容的BioAPI規(guī)范的主/次版本號(hào)，異常BioAPIException,見(jiàn)11.110.2.4.7List(BFPListElement)QueryBFPs(UUIDbspUUID)說(shuō)明返回當(dāng)前安裝在組件注冊(cè)表中，并由給定BSPUUID標(biāo)識(shí)的BSP支持的BFP列表。它按順序執(zhí)行以下操作：a)確定當(dāng)前所有已經(jīng)安裝的BFP中哪些是被BSP支持的；b)用a)中確定的BFP的標(biāo)識(shí)信息(類別和UUID)填充數(shù)組。注：該方法調(diào)用相應(yīng)的BSP.QueryBFPs。通過(guò)調(diào)用enumBFPs并在匹配的BFPUUID上分析BFPSchemaArray,能夠取回關(guān)于所支持的BFP的附加信息。只有在為指定的BSP調(diào)用BSPLoad之后，才能調(diào)用該函數(shù)，而在為此BSP調(diào)用了異常如果出現(xiàn)任何錯(cuò)誤，則拋出BioAPIException,見(jiàn)11.110.2.4.8Lis