本文件规定了一系列以GB/T 30268.1-2013规定的断言语言表述的测试断言。 为测试那些声明符合GB/T 30267.1-2013的BioAPI 2.0框架，本文件规定了应予执行的测试断言。 本文件规定的测试断言并未声明为详尽的(见GB/T 30268.1-2013的第6章)。BioAPI框架的具体实现，只有在按照GB/T 30268.1-2013规定的方法及本文件规定的测试断言测试之后，才能(且仅能)声明符合GB/T 30267.1-2013中为这些断言所涵盖的那些条款。 本文件适用于BioAPI 2.0框架的符合性测试套件的开发和使用。

ICS 35.240.15
CCS L 71
中华人民共和国国家标准
GB/T30268.3—2023/ISO/IEC24709-3:2011信息技术
生物特征识别应用程序接口
(BioAPI）的符合性测试
第3部分：
BioAPI 框架的测试断言
Information technologyConformance testing for the biometric applicationprogramming interface (BioAPI)Part 3 : Test assertions for BioAPIframeworks
（IS0/IEC24709-3:2011,IDT）
2023-03-17发布
国家市场监督管理总局
国家标准化管理委员会
2023-10-01实施
规范性引用文件
术语和定义
缩略语
符合性
BioAPI框架的符合性测试.
测试断言配置
测试流程
初始化与终止
测试断言列表
7.6BioAPI符合性声明
8测试断言·
测试表概述·
XML文本描述
公共活动
断言1.1—BioAPI_Init
断言1.2—BioAPI_Terminate
断言1.3—BioAPI_GetFrameworkInfo断言1.4—BioAPI_EnumBSPs
GB/T30268.3—2023/ISO/IEC24709-3:2011次
断言1.5—BioAPI_BSPLoad_And_BioSPI_BSPLoad断言1.6—BioAPI_BSPUnload_And_BioSPI_BSPUnload断言1.7—BioAPI_BSPAttach_And_BioSPI_BSPAttach断言1.8—BioAPI_BSPDetach_And_BioSPI_BSPDetach断言1.9—BioAPI_QueryUnits_And_BioSPI_QueryUnits8.13
断言1.10—BioAPI_EnumBFPs
断言1.11—BioAPI_QueryBFPs_And_BioSPI_QueryBFPs断言1.12—BioAPI_ControlUnit_And_BioSPI_ControlUnit断言2.1—BioAPI_FreeBIRHandle_And_BioSPI_FreeBIRHandle断言2.2—BioAPI_GetBIRFromHandle_And_BioSPI_GetBIRFromHandle..断言 2.3—BioAPI_GetHeaderFromHandle_And_BioSPI_GetHeaderFromHandle ...断言3.1—BioAPI_EnableEvents_And_BioSPI_EnableEvents断言3.2—BioAPI_SetGUICallbacks_And_BioSPI_SetGUICallbacks57
GB/T30268.3—2023/ISO/IEC24709-3:20118.21
断言4.1—BioAPI_Capture_And_BioSPI_Capture断言4.2—BioAPI_CreateTemplate_And_BioSPI_CreateTemplate断言4.3—BioAPI_Process_And_BioSPI_Process断言4.4—BioAPI_ProcessWithAuxBIR_And_BioSPI_ProcessWithAuxBIR断言4.5—BioAPI_VerifyMatch_And_BioSPI_VerifyMatch断言4.6—BioAPI_IdentifyMatch_And_BioSPI_IdentifyMatch断言4.7—BioAPI_Enroll_And_BioSPI_Enroll断言4.8—BioAPI_Verify_And_BioSPI_Verify·.断言4.9—BioAPI_Identify_And_BioSPI_Identify断言4.10—BioAPI_Import_And_BioSPI_Import...断言4.11—BioAPI_PresetIdentifyPopulation_And_BioSPI_PresetIdentifyPopulation断言5.1—BioAPI_DbOpen_And_BioSPI_DbOpen...断言5.2—BioAPIDbClose AndBioSPIDbClose断言5.3—BioAPI_DbCreate_And_BioSPI_DbCreate断言5.4—BioAPI_DbDelete_And_BioSPI_DbDelete断言5.5—BioAPI_DbSetMarker_And_BioSPI_DbSetMarker断言5.6—BioAPI_DbFreeMarker_And_BioSPI_DbFreeMarker断言5.7—BioAPI_DbStoreBIR_And_BioSPI_DbStoreBIR·.断言5.8—BioAPI_DbGetBIR_And_BioSPI_DbGetBIR断言5.9—BioAPI_DbGetNextBIR_And_BioSPI_DbGetNextBIR断言5.10—BioAPI_DbDeleteBIR_And_BioSPI_DbDeleteBIR断言6.1—BioAPI_SetPowerMode_And_BioSPI_SetPowerMode断言 6.2—BioAPI_SetIndicatorStatus_And_BioSPI_SetIndicatorStatus断言6.3—BioAPI_GetIndicatorStatus_And_BioSPI_GetIndicatorStatus断言6.4—BioAPI_CalibrateSensor_And_BioSPI_CalibrateSenso1断言7.1—BioAPI_Cancel_And_BioSPI_Cancel断言7.2—BioAPI_Free_And_BioSPI_Free断言8.1—BioAPI_Util_InstallBSP..断言8.2—BioAPI_Util_InstallBFP附录A（资料性）
参考文献
多组件支持的测试过程
...208
：213
：249
GB/T30268.3—2023/ISO/IEC24709-3:2011前言
本文件按照GB/T1.1一2020《标准化工作导则第1部分：标准化文件的结构和起草规则》的规定起草。
本文件为GB/T30268《信息技术生物特征识别应用程序接口（BioAPI)的符合性测试》的第3部分。GB/T30268已经发布了以下部分：第1部分：方法和规程；
—第2部分：生物特征识别服务供方的测试断言；一第3部分：BioAPI框架的测试断言。本文件等同采用ISO/IEC24709-3：2011《信息技术生物特征识别应用程序接口（BioAPI)的符合性测试第3部分：BioAPI框架的测试断言》。本文件与ISO/IEC24709-3：2011相比做了下述允许的结构性调整：一第2章对应ISO/IEC24709-3：2011中的第3章；一第3章对应ISO/IEC24709-3：2011中的第4章；一第4章对应ISO/IEC24709-3：2011中的第5章；一第5章对应ISO/IEC24709-3：2011中的第2章。请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别专利的责任。本文件由全国信息技术标准化技术委员会（SAC/TC28)提出并归口。本文件起草单位：长春鸿达光电子与生物统计识别技术有限公司、中国电子技术标准化研究院、北京眼神科技有限公司、北京中科虹霸科技有限公司、厦门市熠成信息技术有限公司、北京集创北方科技股份有限公司、上海市计量测试技术研究院、深圳市铭图创新科技有限公司、武汉虹识技术有限公司、深圳盈达信息科技有限公司、广州广电运通金融电子股份有限公司。本文件主要起草人：王振鑫、刘爽、刘倩颖、王文峰、张树功、杨春林、苏立伟、钟陈、潘云鹏、王佳楠、李星光、石红岩、樊磊、任瑜、李清顺、易开军、王冬生、孙静、张玮、高俊雄。GB/T30268.3—2023/IS0/IEC24709-3:2011引言
GB/T30268建立了生物特征识别产品的符合性测试方法，定义了符合性测试模型以及断言语言，以对生物特征识别服务供方、BioAPI框架及生物特征识别应用等BioAPI组件进行符合性测试。GB/T30268拟由4个部分构成，
一第1部分：方法和规程。目的在于确立生物特征识别产品符合性测试的概念、框架、测试方法和准则。
第2部分：生物特征识别服务供方的测试断言。目的在于为那些声明符合GB/T30267.1-2013的生物特征识别服务供方确立应予执行的测试断言。第3部分：BioAPI框架的测试断言。目的在于为那些声明符合GB/T30267.1一2013的BioAPI2.0框架确立应予执行的测试断言。一第4部分：生物特征识别应用的测试断言。目的在于为那些声明符合GB/T30267.1一2013的生物特征识别应用确立应予执行的测试断言。本文件包含了用以测试那些声明符合GB/T30267.1一2013定义的BioAPI规范的BioAPI框架BioAPI2.0)的符合性的测试断言。并根据符合性子类（如果存在）以及声明的可选功能支持性对这些断言进行了整合。
本文件规定的断言可供本文件的使用者（例如测试实验室）用以测试任何声明其为标准符合性实现的BioAPI框架相对于GB/T30267.1—2013（BioAPI2.0）的符合性。IN
1范围
GB/T30268.3—2023/ISO/IEC24709-3:2011信息技术生物特征识别应用程序接口(BioAPI)的符合性测试第3部分：BioAPI框架的测试断言
本文件规定了一系列以GB/T30268.1一2013规定的断言语言表述的测试断言。为测试那些声明符合GB/T30267.1一2013的BioAPI2.0框架，本文件规定了应予执行的测试断言。
本文件规定的测试断言并未声明为详尽的（见GB/T30268.1一2013的第6章）。BioAPI框架的具体实现，只有在按照GB/T30268.1一2013规定的方法及本文件规定的测试断言测试之后，才能（且仅能)声明符合GB/T30267.1一2013中为这些断言所涵盖的那些条款。本文件适用于BioAPI2.0框架的符合性测试套件的开发和使用2规范性引用文件
下列文件中的内容通过文中的规范性引用而构成本文件必不可少的条款。其中，注日期的引用文件，仅该日期对应的版本适用于本文件；不注日期的引用文件，其最新版本（包括所有的修改单）适用于本文件。
GB/T30267.1一2013信息技术生物特征识别应用程序接口第1部分：BioAPI规范（ISO）IEC19784-1:2006,IDT)
GB/T30268.1一2013信息技术生物特征识别应用程序接口（BioAPI)的符合性测试第1部分：方法和规程（ISO/IEC24709-1：2007，IDT）3术语和定义
GB/T30267.1—2013和GB/T30268.1—2013界定的以及下列术语和定义适用于本文件。3.1
API/SPI路由
API/SPIrouting
由BioAPI框架提供，能够处理多个应用程序和/或多个生物特征服务供方（BSP）的功能。利用该功能，一个来自应用程序的BioAPI调用可以正确地发送给该应用程序指定的BSP，由一个BSP返回的BioSPI可以正确地发送给指定了该BSP的应用程序。4缩略语
下列缩略语适用于本文件。
API：应用程序编程接口（ApplicationProgrammingInterface）BIR：生物特征信息记录（BiometricInformationRecord）BSP：生物特征识别服务供方（BiometricServiceProvider）CTS：符合性测试套件（ConformanceTestSuite）FMR：误匹配率（FalseMatchRate）1
GB/T30268.3—2023/ISO/IEC24709-3:2011FPI：功能供方接口（FunctionProviderInterface）GUI：图形用户接口（GraphicUserInterface）ID：身份/识别/标识符（Identity/Identification/Identifier）IUT：受试实现(ImplementationUnderTest)SPI：服务供方接口（ServiceProviderInterface）UUID：通用唯一标识符（UniversallyUniqueIdentifier）5符合性
声明符合本文件的实现（BioAPI符合性测试套件）应能处理第8章中按照GB/T30268.1一2013规定的方法以及第6章和第7章规定的原则所设定的所有测试断言。6总则
6.1在第7章中列举并在第8章中明确规定测试断言都是基于GB/T30268.1一2013所规定的符合性测试方法论设置的，且其只能用于该方法论的语境。这些断言是以GB/T30268.1一2013规定的断言语言写成的，断言语言是该方法论的一部分，6.2GB/T30268.1一2013规定的符合性测试方法论的一个重要构想是设置三种符合性测试模型（见GB/T30268.1一2013的第6章）。a）BioAPI应用符合性测试模型；b）BioAPI框架符合性测试模型；c）BioAPIBSP符合性测试模型。6.3每种测试模型都适用于BioAPI架构的三个标准组件中对应组件的测试（见GB/T30268.1一2013第6章）。本文件的第8章详细介绍了用于BioAPI框架符合性测试模型的测试断言。本文件不涉及BioAPI应用程序、BSP及相应测试断言的符合性测试模型。6.4在BioAPI框架的符合性测试模型中，应使用特定的测试组件（称为“框架测试应用”）替代标准应用程序，并应使用另一特定测试组件（称为“框架测试BSP”）替代标准BSP（见GB/T30268.1一2013的6.2.5.2)。
7BioAPI框架的符合性测试
7.1通则
7.1.1第7章描述BioAPI框架符合性测试的测试条件设置原则以及通过/失败结果的创建原则。7.1.2受试BioAPI框架的测试条件设置原则如下：一所有BioAPI函数和相关的BioSPI函数均应测试：一每个函数中的所有参数均应测试；——每个参数的所有可取规定值均应测试；与测试案例相关的测试BSP的BSP架构的所有属性均应测试。7.1.3BioAPI框架测试案例通过/失败结果的创建原则如下：返回值均应检查。如果GB/T30267.1一2013未规定某个特定BioAPI函数的错误值，但其返回了一个可能的错误值，则应通过该测试；对于输出参数，若GB/T30267.1一2013要求BioAPI框架设定输出参数的值，则输出参数均应检测；
一对BioAPI框架从BioAPI函数传输到BioSPI函数的参数，测试断言应检测是否所有参数都2
得以正确传输。
GB/T30268.3—2023/ISO/IEC24709-3:2011注1：本文件中，测试断言不包含具有各种参数组合的测试案例、具有各种BioAPI函数序列的测试案例、具有回调函数的测试案例、与异步行为相关的测试案例、由测试BSP的非正确实现导致的错误案例和仅仅与测试BSP的可选功能相关的测试案例。
注2：附录A描述了一种BioAPI框架的多组件支持的测试案例。该案例可作为实现BioAPI框架的API/SPI路由特性测试的推荐符合性测试套件。注3：关于无效参数的错误处理，GB/T30267.1一2013允许BioAPI框架和BSP自由实现。为创建符合GB/T30267.1一2013的测试断言，宜考虑下列情形：a）按照GB/T30267.1一2013的规定，如果BioAPI函数的某个参数的规定值是不正确的，则不必规定Bio-API函数返回的错误值。对此情形，测试断言仅需检测是否返回了某一个可能的错误值，而且在需返回特定错误值的测试断言中不规定具体的返回值GB/T30267.1一2013并没有具体说明BioAPI框架是否要进行参数检测，或测试BSP是否应做这个检b）
测。因此在本文件中，测试断言在检测参数时不关注哪一个组件(BioAPI框架或BSP)发现了错误。因而测试断言不检测其高8位可由BioAPI框架或BSP设置的错误码。甚至在BioAPI函数中的参数出现错误之后，也不检测BioAPI框架是否调用了对应的BioSPI函数。以下是BioAPI框架无需调用相应BioSPI函数就可以确定地处理错误的例子：参数中的值是不相关的；例如BioAPI_PURPOSE_AUDIT这样与注册目的无关的值被设置为Bio-1）
API_Enroll函数中的Purpose参数。BSP不支持参数中的值；尽管BSP不支持规定Subtype的功能，但是Subtype参数中仍然指定了诸2）1
如BioAPI_BIR_SUBTYPE这样的值。7.2测试断言配置
7.2.1一个测试断言由三个表格和一个XML文本构成，这三个表格与受试BioAPI函数相关，而XML文本与BioAPI函数或BioSPI函数相关7.2.2构成测试断言一部分的三个表格分别为：一默认输人表，该表汇集了BioAPI函数的所有输人参数的默认值；-测试条件表，该表汇集了BioAPI函数测试过程中所给出的所有条件；一预期结果表，可通过比较该表中的预期测试结果与BioAPI框架给出的值来创建通过/失败结果。
在测试条件表中，每行表示一个测试案例，每列表示：赋予BioAPI函数参数的值；
与测试案例相关的BSP架构信息；BSP通过BioAPI函数返回的值
在预期结果表中，每行表示一个与测试条件表相同的测试案例，而每列表示了用来决定通过/失败的参考信息。在决策时，可使用与测试案例相关的返回值和输出参数注：为简化表达式，在第8章的每个子条款的测试断言仅使用了词汇“测试条件表”和“预期结果表”，去掉了诸如BioAPI和/或BioSPI函数名这样的后缀。7.2.3在调用待测BioAPI函数之前，测试应用程序应首先读取默认输人表中描述的值，然后通过提取测试条件表的某一行来读取一个相应的测试条件。这样的操作意味着所有的输入参数都由测试应用程序设定。设定的方式是先由测试应用程序参考默认输人表设置所有的输入参数，然后将其中一个参数的值用测试条件表中描述的值覆盖。测试应用程序应在每次执行测试案例时反复读取这两个表。7.2.4默认输人表描述了受试BioAPI函数的输人参数名称和输入参数值。参数的次序与GB/T30268.1—2013中描述的次序相同。7.2.5测试条件表描述了下列信息。a）
输人参数名称与输人参数值：描述赋予受试BioAPI函数的参数b）BSP架构的支持选项：在BSP架构的BioAPI_OPERATIONS_MASK和BioAPI_OPTIONSMASK中选择与测试案例相关的选项，以表明测试案例是否支持这些选项。测试条件表的细节将在7.3和第8章中描述。www.bzxz.net
GB/T30268.3—2023/IS0/IEC24709-3:2011（来自BioSPI的）返回值：表明BioSPI函数被BioAPI框架调用后从测试BSP返回的值。可从c）
多个可能的返回值中选择一个被认为恰当的值返回，并在表中予以描述。在预期结果表中，每行包含了返回值和一个参数名称以及该参数的值，该参数值可用来做出通7.2.6
过/失败的决定。预期结果表将在7.3和第8章描述。7.2.7XML文本描述了测试应用程序操作的逻辑关系。测试应用程序在调用受试BioAPI函数之前，先利用7.2.4描述的默认输人表和7.2.5描述的测试条件表，使用元素设置参数；在受试BioAPI函数返回到测试应用程序后，再使用元素，通过读取7.2.6描述的预期结果表获得预期结果，最后做出通过/失败决定。对同一BioAPI或BioSPI函数，所有测试案例都具有如前所述的相同逻辑，因此原则上，对同一个BioAPI或BioSPI函数只有一个XML文本，并无例外7.2.8BioAPI框架的CTS结构见图1。7.2.8.1CTS由测试应用程序、测试BSP、XML文本、两个测试表和受试BioAPI框架构成。测试应用程序和测试BSP都读取XML文本和测试表，并将其翻译为计算机上可执行的二进制文件再运行之。此外，测试应用程序与测试BSP通过BioAPI框架返回的信息来检测BioAPI框架的行为，然后做出通过/失败决定。
注：CTS负责将测试条件表中的值赋予XML文本中的变量，这些内容不在本文件的讨论范围之内。测试应用
测试开始
1选择一项测试
包xxx
--输入参数—
input inparal var il
input inpara2 var_i2
—函数调用-
invoke BioAPI_xxx
—输出参数-
input return var_ret
input outparal var ol
Input outpara2 var_02
-检查结果-
check return val ret
check outparal var_ol
：逻辑流；
★：数据流。
2通知测试编号
函数A
包aaa
Invoke
BioAPIaaa
3获得测试脚本
XML文本
输入参数
4获得测试表
测试表
函数A
获得测试脚本
测试BSP
函数Z
获得测试表
输出参数
图1BioAPI框架的CTS结构
通过/失败
受试框架
GB/T30268.3—2023/ISO/IEC24709-3:2011测试BSP应具有根据测试条件表的描述改变BSP架构的BioAPI_OPERATIONS_MASK和7.2.8.2
BioAPI_OPTIONS_MASK成员的能力。BSP架构与BioAPI框架符合性测试相关的成员如表1所示。
表1与本文件相关的BSP架构成员序号
测试流程
BSPUuid
Description
SpecVersion
ProductVersion
Vendor
FactorsMask(BiometricType)）Operations
Options
PayloadPolicy
MaxPayloadSize
DefaultVerifyTimeout
DefaultIdentifyTimeout
DefaultCaptureTimeout
DefaultEnrollTimeout
DefaultCalibrateTimeout
MaxBSPDbSize
MaxIdentify
取决于CTS
取决于CTS
0x20（版本2.0）
取决于 CTS
取决于CTS
0x00000001(BioAPI_TYPE_MULTIPLE）取决于测试条件表
取决于测试条件表
取决于 CTS
1024（字节）
10000(ms)
10000(ms)
10000(ms)
10 000(ms)
10000(ms)
10240（字节）
0xFFFFFFFF（不限）
在执行测试之前，选择一个测试案例（见图1的“1选择一项测试”）。2测试应用程序将欲进行测试的唯一测试案例的相关信息通知BSP（见图1的“2通知测试编7.3.2
号”）。通知的具体实施方式不在本文件的讨论范围内，它取决于每个CTS。（例如，测试BSP支持某个函数，该函数仅用于发送测试程序需接收的通知，然后测试BSP在调用待测BioAPI函数之前调用该函数，以便能查明选中的测试案例）。在测试中，当BioAPI框架调用BioSPI函数时，测试BSP可以利用这种通知特性，预先读取相应的XML文本和测试表来为测试案例做准备，创建适当的BSP架构并生成BioSPI函数的返回值。
如同测试BSP的操作一样，测试应用程序读取相应的XML文本与测试表，并准备待测BioAPI函数的参数（见图1的“3获得测试脚本”）。注：7.3.2与7.3.3可不按此处列出的次序执行。7.3.4在设置了测试案例的相应参数后，测试应用程序调用BioAPI函数（见图1的“4获得测试表”）。当发现某个规定参数与BSP架构中BioAPI_OPERATIONS_MASK或BioAPI_OPTIONS_MASK的某个属性产生矛盾时，由BioAPI框架的实现决定是否返回错误值。在前述情况下,BioAPI框架无须调用测试BSP即可直接向测试应用程序返回一个错误值。测试应用程序将创建一个通过/失败报告（见5
小提示：此标准内容仅展示完整标准里的部分截取内容，若需要完整标准请到上方自行免费下载完整标准文档。