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

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