发明背景

此申请案请求1999年5月21日提出的第60/135,268号美国临 时申请的权益。

本发明提供一种软件体系，使电视顶设终端机的核心软件能够 与不同的顶设中间软件和操作系统软件兼容。特别地，一位于(i)中 间软件和操作系统提供者软件、与(ii)电视机顶盒等中提供的核心 顶设软件之间的软件接口定义了在其间的函数和参数。

数字顶设终端机的出现刺激了用户电视网络，例如有线/卫星电 视网络，的成长。这种终端机可支持更高级别的编程服务，以及各 种基于软件的应用程序和功能，例如电子节目指南，股票或气象看 板，购物和银行的家庭服务，游戏等。而且，预计这种趋势将随着 电话，电视和计算机网络以及室内计算机网络的兴起而继续发展。

用于有线或卫星电视等的“用户终端机”(例如，数字机顶盒)， 需要操作系统软件、中间软件和设备驱动程序来发生效用。

操作系统软件提供操作顶设所需要的多线程、实时操作系统支 持。

中间软件是连接二个不连接的独立应用程序的软件。例如，提 供这样的中间软件以作为一个应用程序和一个网络之间的媒介，藉 此管理横跨不同计算平台的不同应用程序之间的交互作用。更一般 而言，中间软件用作独立应用程序之间的粘着剂，并且由于其连接 一个应用程序的两边，并在其间发送数据，所以有时被称为“管道” (plumbing)。

此外，驱动器用于控制一终端机中的不同硬件设备，诸如调谐 器，解调器，MPEG-2解码器(例如，音频，视频和数据)，视频编 码器，音频混合器等。

在一个机顶盒中提供“核心软件”，其允许该顶设提供下述必要 的电视功能：服务取得，系统信息(SI)管理，下载能力(例如对 于新的应用程序和操作系统(OS)软件)，返回路径通信(例如为列 表目的而轮询顶设)，顶设配置，以及条件存取控制(即安全性)。

过去，每一顶设被设计为仅使用一特定操作环境。从前并未针 对顶设环境提出处理多重操作环境的问题。一般而言，应用程序或 者通过通过将顶设系统软件重写成该环境下的软件，或者通过一提 取(abstraction)层而转至各种操作环境。

因此，其好处为：无需改变核心顶设系统软件即可在一顶设上 选择不同的操作环境。这使得能够将一种顶设设计重覆用于多个操 作环境中。同时可更快地实现操作软件环境的更替，同时使新的顶 设设备在更快时间内上市。

特别是，期待能有这样一种软件体系结构，其允许一用户、诸 如一有线电视系统操作员，来选择顶设中所使用的操作环境和设备 驱动器，其中操作环境包括操作系统(OS)核心，中间软件和应用 程序软件。该核心顶设系统软件应当允许该装置在一共用系统环境 中操作。该体系结构应当允许在多个不同操作环境中的任一操作环 境下开发核心软件，然后实现该体系结构，其中操作环境包括诸如 VRTX，WINDOWS CE，AperiOS，PowerTV以及其他顶设操作环境。

此体系结构应该使中间软件和操作系统软件能够控制核心顶设 系统软件并与其交互作用，以利于提供想要的数字电视服务，例如 服务取得、判断服务的状态、配置顶设、指示自发事件和管理用户 保密权。

该体系结构应当适用于通过任何类型的网络来接收节目服务的 终端机，其中所述网络包括宽带通信网络，数字用户环(DSL)网 络等。本发明提供一种与核心顶设系统软件的接口，该接口拥有上 述的和其他的优点。

还期望使与核心顶设软件的接口在这样的体系结构中操作。

特别地，本发明的接口定义了顶设软件的“应用程序OS/中间 软件”层和核心顶设系统软件之间的每一接口点。这就提供了一种 机制，应用程序OS/中间软件可藉其控制核心顶设系统软件及与其 交互作用。

发明概要

提供一种软件接口，使顶设中间软件和操作系统软件能够控制 并与核心顶设系统软件交互作用。此接口使中间软件和操作系统软 件能够与核心系统软件交互作用，以利于提供想要的数字电视服务。

依照本发明的一种装置提供一种与一电视用户终端机中的核心 系统软件的接口，且包括一具有计算机程序码装置的计算机可读介 质，和用以执行计算机程序码装置的装置，其提供至少一应用程序 接口(API)，使作为一应用程序和该核心系统软件之间的媒介的中 间软件能够访问终端机的功能(function)。

另外还提供了一种对应的方法。

附图说明

图1是采用了依据本发明的中间软件/操作系统层和核心顶设系 统软件之间的软件接口的电视机顶盒结构的概略图。

发明详述

图1说明了根据本发明的用以实现机顶盒的软件平台或体系结 构。该平台可使用任意适当的操作系统来实现，诸如位于Oregon， Wilsonville的Mentor Graphics公司所提供的VRTX(虚拟实时执行 的)操作系统，位于Washington，Redmond的微软公司所提供的 WINDOWS CE，位于N.Y.，New York的Sony公司所提供的AperiOS， 位于CA，Cupertino的Power TV公司所提供的Power TV等。也可 使用其他操作系统。

该体系结构被认为包括三个主要层次，其中包括与硬件和设备 驱动器功能相关的低层(功能30，32和34)，与核心顶设软件相关 的中间层(功能14，16，18，20，22，24和26)，以及与中间软件 和应用程序相关的高层(功能10，12)。

具体地，软件结构的顶层包含一个或多个应用程序10，例如可 包含数字电视(DTV)导航器应用程序(由位于北卡罗来纳州charlotte 的网络控制国际公司所提供)，互动式游戏，增强的电视特性，因特 网的网页浏览器等。这些应用程序需要与核心顶设系统软件20进行 通信。此通信是通过中间软件/应用程序接口12，中间软件转移层14， 和本发明的软件接口26加以完成。

软件体系中的下一层包含中间软件/应用程序接口API(应用程 序接口)12。这一层12是操作环境的一部分(即，它是专用操作系 统)，并提供与顶设(例如，有线顶设硬件34)中执行的应用程序10 的接口。层12提供用于应用程序的软设备，以使用及控制机顶盒资 源，并与其他应用程序并存。层12同时提供用以执行应用程序的环 境。层12还提供用以编写应用程序的API，同时提供一程序设计 (authoring)环境。此外，此层12处理共享资源的发送(issue)、 多重应用程序、应用程序选择、应用程序装入(launch)以及应用 程序终止。最好，其向终端使用者提供一种兼容的接口。

例如用于有线、DSL或其他电视服务的中间软件转移层14是用 以分别将电视，图形与通信接口20，22和24转换成中间软件的组 成部分所需要并由中间软件的供应者/厂商所指定的特殊的功能接 口。中间软件供应者通常指定一个已经在其上测试和验证了其软件 的接口。还作为部分操作环境的层14允许以一方便的方式将中间软 件解决方案移植至该顶设。更具体地，在允许执行不同中间软件层 的同时，层14允许核心顶设系统软件20保持原状。

在包括中间软件转移层14与核心顶设系统软件20，图形、音 频、视频子系统22和网络通信堆栈24的层提供操作系统(OS)核 心16。此核心16可包含例如由Mentor Graphics公司的微技术部 门提供的专用于Motorola 68000系列微处理器的4.0版VRTX核心 的MIPS(每秒百万指令)端口。此核心16提供了操作顶设所需的 多线程实时操作系统(OS)支持。连同中间软件转移层14与中间软 件/应用程序接口API 12的操作系统(OS)核心16和设备驱动器均 为操作环境的组成部分。特别是，操作系统(OS)核心16提供诸如 多重任务处理，内部任务通信，同步化，以及存储器管理等操作系 统(OS)软设备。这些软设备用于创建任务，设定任务优先级，进 行任务间的通信，以及系统任务与应用程序任务的同步化操作。

根据本发明的核心提取组成部分18提供其他组成部分所需的一 般核心功能。特别是，组成部分18从操作系统(OS)核心16的特 定功能(specifics)中提取出这些功能。核心提取组成部分18包 括两部分，即，(i)由组成部分所用的核心调用，以及(ii)专用 核心转换。某些所支持的核心特性是以独立于基础核心的方式实现 的。

核心提取组成部分18可以将操作系统(OS)核心的细节与核心 顶设系统软件20加以分离，并将核心系统软件与一操作系统(OS) 核心实现的特定功能加以隔离。以此方式，可提供操作环境间的核 心软件20的可移植性。操作系统(OS)核心提取18以一种一般方 式向核心系统软件20提供标准类型的操作系统(OS)服务。这些服 务例如包括：消息接发，线程操作，存储器管理，同步化，以及事 件管理。

核心顶设系统软件20包含对电视系统特性的支持。例如，此软 件可被编写成支持DigiCipherII数字电视系统特性。DigiCipher II是由其受让人，美国Pennsylvania，Horsham的通用仪器公司所 开发的专属系统。此系统包括专用于进行顺流以及逆流通信的有线 电视环境的特性。这些由核心顶设系统软件20所支持的特性包括但 不仅限于服务取得(例如，获得付费选看的电影)，系统信息管理， 顶设配置与控制，轮询的返回路径，包含认证与授权的下载能力， 以及非易失性存储器管理。

核心顶设系统软件20还包括条件式存取系统驱动器(CABIOS)， 用以提供安全性和存取控制。此组成部分支持对象认证，对象授权， 资源授权，加密工具箱，以及基线密钥交换的特性。用于加密工具 箱(密码工具箱)的接口层是公用密钥加密标准(PKCS)11。

更具体地，核心顶设系统软件20提供允许顶设存在于一通信(例 如有线电视)网络中的服务。如上所述，此软件的功能包括：

消息接收与发布——此软件组成部分在一控制频道上或者通过 一带内频道接收消息，并将其发布到用于解释和处理的适当软件进 程。

系统信息处理——此组成部分解释由用于指定调制类型，频道 映射，服务映射，服务说明，服务组成部分的协议(例如先进电视 系统委员会(ATSC)，或者数字视频广播(DVB)标准)提供的系统 信息。此信息允许软件查找、重建、和向使用者或者应用程序发送 发送该服务。

配置与控制消息处理——此组成部分解释从例如一有线头端控 制器传送到顶设的配置与控制消息。此信息是用以提供一个在有线 电视系统或其他可用网络内操作的顶设。该组成部分设定顶设的特 性，并提供由操作员遥控顶设操作的能力。

数字和模拟服务取得——此组成部分执行“调谐”一个呈现给 电视观众的视频/音频服务所需的所有必要功能。

条件式存取子系统——此组成部分对服务与应用程序进行授 权。视频服务以加密的形式被发送到顶设。条件式存取(CA)系统 将有关该服务的授权信息与发送到该顶设的授权信息进行比较。当 认可一服务已被授权时，则该CA系统可将该服务解密。

下载子系统——此组成部分从有线或其他可用网络获得软件对 象，并将其存储在顶设存储器中。这些对象可包括例如软件组 (software suite)或应用程序。该下载子系统确定其是否已被授 权接收对象，并且如果是，则处理并储存该对象的每一区段 (segment)。一旦该对象被存储，则其被确认，并能通过例如头端 控制或者通过操作系统执行该对象。

返回路径子系统——此组成部分收集购买与诊断信息，并且根 据命令将其返回头端(或其他适当的系统操作员位置)。最后将此信 息传送至一记帐系统，以便能够对该顶设所使用的服务记帐。返回 路径可为一储存-转送机构，或者一请求式人机对话机构。

诊断数据管理子系统——此组成部分收集并管理可用以诊断顶 设状态、允许远程确定该顶设软件的操作及完好的数据。此数据可 供操作系统(OS)向使用者或安装人员进行显示。其同时可供返回 路径子系统用，而由该系统操作员位置(例如于一有线头端)上的 一计算机加以集合。

CABIOS(条件式存取基本服务)在正常的服务存取控制的基础 上提供条件式存取服务，包括：

对象认证——此功能认证一软件对象，以确定该对象是否为所 考虑的对象。这类认证例如通过匹配随该对象一起发送的签名而完 成。

对象授权——此功能授权被载入顶设中及在顶设中执行的对 象。其使用条件式存取硬件来确定顶设的授权状态。

资源授权——此功能授权通过条件式存取硬件而使用顶设资 源。

基线密钥交换服务——这些功能支持有线调制解调系统的密钥 交换请求，其符合有线加载数据服务接口规定(DOCSIS)。

密码功能——这些功能提供了一个基本的密码工具箱，供顶设 内的应用程序操作系统及应用程序使用。虽然可使用其他标准，但 如以上所指示，典型的密码工具组遵循PKCS 11标准。

在最佳具体实施例中，图形、音频及视频子系统22包括二维 (2D)、三维(3D)和操作于图形显示驱动器顶层的视频数据库。这 类显示驱动器通常由诸如位于加拿大Ontario，Thornhill的ATI科 技公司的各供应商提供。子系统22提供一个标准API，中间软件供 应者可转移至此，并能使要观赏的视频信号与图形相组合。尤其是， 将模拟或数字视频与一图形重叠组合，以呈现给使用者一个组合画 面。此子系统22同时提供可存在于多种模式下的音频，诸如立体与 环绕音效。该音频子系统同时可支持音频文件的记录及回放。

网络通信堆栈24提供标准化的网络堆栈，用以辅助网页浏览以 及与外部设备的通信。此子系统24包括多种可通过多条通信路径发 送的标准化网络协议。该堆栈可包含例如Mentor/Microtec的延伸 至由Mentor图形公司提供的VRTX操作系统的CNX通信。

此子系统24驻留于通信驱动器(例如乙太(Ethernet)和DOCSIS 驱动器)的顶层，并提供例如一个Berkeley插座(Berkeley软件 设计公司)，作为与诸如传输控制协议(TCP)/网际网络协议(IP) (例如一DOCSIS调制解调器或者乙太网(Ethernet)设备上的一 TCP/IP接口)、用户数据报协议(UDP)、地址解析协议(ARP)、网 间控制报文协议(ICMP)、动态主机配置协议(DHCP)客户、域名系 统(DNS)客户以及点对点协议(PPP)(拨号使用CCP，链接控制协 议(LCP)以及网间协议控制协议(IPCP)的协议等的接口。

如所属领域所公知的，对于用以操作机顶盒以实现所希望的功 能的顶设硬件34来说，必须提供各种驱动器。在图中，这些驱动器 是以低阶(low level)设备驱动器32加以描述，其通过设备驱动 器与驱动器模组的接口30与核心顶设系统软件20所使用的一驱动 器模组接口。

接口30将驱动器模组环境的细节与核心系统软件20加以分离， 并用以将设备驱动器32与操作环境所提供的专有驱动器模组加以隔 离。低阶设备驱动器软件32是专有硬件，并可跨操作环境使用。驱 动器模组接口30通过向专有硬件的设备驱动器32提供操作系统 (OS)所希望的接口，而将该驱动器与操作系统(OS)结合。

设备驱动器用于顶设上所支持的每一设备。这些驱动器包括一 图形驱动器，其可在例如由ATI科技公司所提供的ATI硬件存取提 供(HAP)层上编写。顶设中所使用的图形数据库可在HAP上编写。 其他典型的顶设设备驱动器包括一通信驱动器，调谐器(例如通用 器材DOCSIS调谐器和正交调幅(QAM)码的组合)，串行端口(使用 例如IEEE 1394高性能串行总线)，并行端口，乙太网(Ethernet) 端口，通用串行总线(USB)端口，发光二极管(LED)，键区和/或 键盘驱动器，一DOCSIS驱动器、诸如由位于美国加州Irvine的 Broadcom公司所提供的Broadcom DOCSIS驱动器，以及一个智能卡。 一智能卡可在顶设中使用，用于诸如在线购买等用户采购应用程序。 顶设中的每一设备都需要一驱动器功能来操作。

下面说明软件接口26(称为“GlTV”)的细节，其定义由核心 顶设系统软件20提供给应用程序操作系统和中间软件方案 (solution)提供者的服务。此接口可使用本领域技术人员所周知 的任何已有技术来实现。

软件接口函数

1.服务取得和服务状态API

1.1. 服务取得概观

服务取得是允许一客户获得顺流服务的进程。服务取得软件管 理服务取得进程。当前为初级(primary)和背景数字服务的 DigiCipher II(DC II)取得提供支持。此处受让人所专有的DC II 类似于MPEG-2。也提供对模拟服务取得的支持。

一次只可取得一初级服务。不能在同一时间取得数字初级服务 和模拟初级服务。

1.2. AcquireServiceBlocking

用于使用指定的服务路径(调谐器)来调谐一个指定的虚拟频 道号码(VCN)或源ID(ID)。所取得的服务是终端机中的主要服务， 且取代先前所调谐的主要服务。此调用返回一个指示在服务API时 所遇到的任何错误的状态。

1.3. AcquireServiceNonBlocking

用于在指定的服务路径上调谐一指定的虚拟频道号码(VCN)或 源ID。AcquireServiceNonBlocking初始化一服务的取得，但在返 回之前不等待取得的完成。由API返回的状态指示任何将会阻止API 被服务的基本错误。如果初始调用没有错误，那么在完成服务取得 (无论成功还是失败)时，调用用户定义的调回函数，传递用户指 定的回呼数据结构。

1.4. GetServiceStatus

用来请求关于在指定服务路径上当前被调谐的主要服务的状态 信息。其包括服务路径、虚拟频道号码、频道盖写状态、服务类型、 服务组成流状态、服务取得状态和节目状态。此调用返回一个指示 在服务API时所遇到的任何错误的状态。

1.5. RegisterServiceStatus

用来记录用户对在指定服务路径上当前被调谐的主要服务的自 发服务状态更新。由API所返回的状态指示任何将会阻止API被服 务的错误。如果初始调用没有错误，则在服务状态改变时调用用户 定义的调回函数，传递用户指定的回呼数据结构。

1.6. CancelSefviceStatus

用来取消RegisterServiceStatus API所建立的服务状态更新 的记录。此调用返回一个指示在服务API时所遇到的任何错误的状 态。

1.7. GetVCTData

用来得到系统中所定义的全部虚拟频道的当前虚拟频道表信息 的摘要。API分配并填充VCT数据结构，其包括一条用于每一所定 义虚拟频道的记录。此调用返回一个指示在服务API时所遇到的任 何错误的状态。

1.8. GetVCTDocskData

用来得到所定义的全部DOCSIS顺流频道的当前虚拟频道表信息 和特性的摘要。DOCSIS顺流频道被定义为任何具有一等于23005的 源ID的虚拟频道。API分配并填充VCT DOCSIS数据结构，其包括 一条用于每一所定义DOCSIS频道的记录。此调用返回一个指示在服 务API时所遇到的任何错误的状态。如果虚拟频道表中没有DOCSIS 频道，API将返回错误状态值SAOER_VCT_NO_DOCSIS，且将不分配任 何存储器给DOCSIS数据结构。

1.9. SelectServiceComponent

用来将一指定类型的服务组成加入到指定服务路径上的主要服 务中。如果该组成是一文本或数据组成，API将用于新组成的连接 ID设置在用户分配的存储器单元中。此调用返回一指示在服务API 时所遇到的任何错误的状态。

1.10. DeselectServiceComponent

用来从所述服务路径上的主要服务中取消选定指定的组成。 被取消选定的服务组成成为无效。此调用返回一个指示在服务API 时所遇到的任何错误的状态。

1.11. SelectServicelPData

用来选择一载送特定多址传送IP数据报的服务组成。这些数据 报在数字视频广播(DVB)-多协议封装(MPE)数据报单元消息中被 载送，其包含具有直接与IP数据报的多址传送IP地址相关的多址 传送MAC(介质存取控制)地址的报头(参见线上数据服务接口规 范一DOCSIS，基线保密接口规范[SP-BPI-101-970922])。

调用的程序将通过指定多址传送MAC地址来选择所要的多址传 送数据。这个调用将返回一个设置在存储器中的连接ID，所述存储 器以由作为调用一部分的指针所指示的位置为起始地址。连接ID识 别载送所请求的多址传送数据的包标识符(PID)流以及目标DVB-MPE 数据报单元的MAC地址。通常，连接ID将直接与作为调用一部分的 特定多址传送MAC地址相关。然而，可选择性地选择一不规则的监 听模式。在这个模式中，载送IP数据的每一数据PID组成将被标识， 所以所有的IP数据报片段可传给调用的程序。在不规则模式中，所 返回的连接ID将映射到所有载送IP数据的组成PID和在当前所调 谐的服务当中载送的所有有效多址传送MAC地址。

ReadServiceIPData需要返回的连接ID以检索所请求的IP数 据。调用的程序也规定服务进程应继续寻找所请求的数据，即使它 未立刻识别出一目标PID流。或者，调用程序规定只应该进行一次 尝试来定位载送所请求数据的PID流。此调用也返回一个指示在服 务API时所遇到的任何错误的状态。

1.12. ReadSefvicelPData

用来从载送一个或更多基本PID流组成的DVB-MPE数据报单元 中提取IP数据报片段。传递到这个API的连接ID识别基本PID流 组成和所请求的DVB-MPE数据报单元的多址传送MAC地址。在某些 情况下，连接ID将指向在当前所调谐的服务中载送的每一数据报单 元，而不管它的多址传送MAC地址。这发生在如果对 SelectServicelpData的先前调用是以listenMode＝ “PROMISCUOUS”进行，而非listenMode＝“NORMAL”。

ReadServicelPData一旦读取被发出就返回一状态，该状态指 示在服务API时所遇到的任何错误。实际消息是通过讯息发送软件 使用调回函数和回呼数据结构发送到用户。

对ReadServicelPData的调用将会造成只有IP数据报片段被传 递到调回函数。因此，DVB-MPE数据报单元报头和CRC报尾在传递 讯息(即，IP数据报)到请求用户之前将会被消除。注意，如果例 如检测到一频道变化，ReadServiceIPData将通过回呼，返回一个 不连接状态。

1.13. DeselectServiceIPData

用来取消选定先前通过SelectServiceIPData调用选择的所述 流组成。这个调用不像标准的DeselectServiceComponent一样需要 组成ID。被取消选定的服务组成成为无效。此调用返回一个指示在 服务API时所遇到的任何错误的状态。

1.14. PostComponentRead

用来请求来自先前使用SelectServiceComponent API选择的 一文本或数据服务组成的讯息。用户指定文本或数据服务组成的连 接ID。PostComponentRead一旦读取被发出就返回一状态，该状态 指示在服务API时所遇到的任何错误，而实际讯息被讯息发送软件 使用调回函数和回呼数据结构发送到用户。

1.15. AcquireBackgroundServiceBlocking

用来从指定服务源获得顺流数据。所传递的多址传送16位地址 阵列允许用户指定用来接收讯息的多址传送地址组。API将用于新 服务的正确ID设置在用户分配的存储器单元中。此调用返回一个指 示在服务API时所遇到的任何错误的状态。

1.16. AcquireBackgroundServiceNonBlocking 用来从指定的服务源获得顺流数据。所传递的多址传送16位地址阵 列允许用户指定用来接收讯息的多址传送地址组。 AcquireBackgroundServiceNonBlocking初始化服务的获得，但并 不在返回之前等待此获得的完成。API将新服务的连接ID设置在用 户所分配的存储器单元中。API返回的确认响应指示将阻碍API被 服务的基本错误。如果起始的调用没有错误，那么在服务取得的完 成时(不论成功或失败)，将调用用户所定义的调回函数，传递用户 分配的回呼数据结构。

1.17. ReleaseBackgroundService

用来释放对来自指定服务连接的顺流数据的存取。此调用返回 一个指示在服务API时所遇到的任何错误的状态。

1.18. PostBackgroundRead

用来接收来自先前使用AcquireBackgroundServiceBlOcking或 AcquireBackgroundServiceNonBlocking API而取得的指定背景服 务连接的数据或文本。PostBackgroundRead一旦读取被发出就返回 一状态，指示在服务API时所遇到的任何错误，而实际讯息被讯息 发送软件使用调回函数和回呼数据结构发送到用户。

1.19. SourceIDtoVCN

用来获得与指定SourceID有关的虚拟频道号码。如果有多个VCN 与一个源ID相关，则返回相关的VCN的完整清单。一次成功的调用 将填入API分配结构中，其包括实际上与VCN相关的VCN数目，实 际上返回给此调用的VCN/服务类型对的数目，和所定义的每一VCNs 的实际VCN和服务类型(模拟对数字)。API将把所传递的指针指派 到所分配的结构中。此调用返回一个指示在服务API时所遇到的任 何错误的状态。

1.20. VCNtoSourceID

用来获得与指定VCN有关的源ID。一次成功的调用将填入用户 所分配的SourceID参数。只有一个源ID与一个VCN有关。此调用 返回一个指示在服务API时所遇到的任何错误的状态。

1.21. PendingVCTChange

用来获得从所指定的(GPS-全球定位卫星)的时间传递到虚拟 频道表(VCT)中的未决改变的清单。一次成功的调用将被填入具有 未决VCT改变的API分配结构中，并指派所传递的指针给所分配的 结构。每一未决变化包括虚拟频道号码、服务源ID、和指示对VCT 的改变被调度发生时间的全球定位系统(GPS)时间。此调用返回一 个指示在服务API时所遇到的任何错误的状态。

1.22. GetDCBM

用来获得用于指定频道类型的定义频道位映象(DCBM)。DCBM 是一个代表当前定义的虚拟频道(服务)的位映象。一次成功的调用 将填入用户分配的DCBM阵列中。这个定义频道的清单以每个服务一 个位元位置地作为多位包阵列提供。位值1表示一个定义的频道，0 表示未定义。此调用返回一个指示在服务API时所遇到的任何错误 的状态。

1.23. ServiceComponentSplice

用来识别一服务的下一音频及/或视频组成，并确定音频及/或 视频是否被转换。

1.24. AppIDtoVCN

用来获得与指定VCN相关的应用ID。一次成功的调用将填入用 户分配的pVcn参数(对VCN信息的一指针)中。只有一个VCN与一 应用ID有关。此调用返回一个指示在服务API时所遇到的任何错误 的状态。

1.25. VCNtpAppID

用来获得与特定VCN有关的应用ID。一次成功的调用将填入用 户分配的应用ID参数。只有一个应用ID与一VCN有关。此调用返 回一个指示在服务API时所遇到的任何错误的状态。

1.26. SourceNametoAppID

用来获得与指定源名称字符串有关的应用ID。一次成功的调用 将填入用户分配的pApplD参数(指示应用ID位于何处的指针)。只 有一个应用与一源名称字符串有关。此调用返回一个指示在服务API 时所遇到的任何错误的状态。

1.27. ApplDtoSourceName

用来获得与指定应用标识符有关的源名称字符串ID。一次成功 的调用将填入API所配置的源名称字符串参数和用户分配的名称长 度参数。只有一个源名称字符串与一应用ID有关。此调用返回一个 指示在服务API时所遇到的任何错误的状态。

2.系统API

2.1. SysRequestConfiguration

用来取得当前终端机配置。此调用返回一个指示在服务API时 所遇到的任何错误的状态。

2.2. SysRequestEPGConfig

用来取得以下电子节目指南(EPG)信息：

·组指派配置，当前组指派的清单。组指派提供指派一顶设给 一特定应用组的装置。

·货币(currency)区域配置-定义货币区域。货币区域可用来 定义不同的成本区域。

·EPG区域配置-从应用的角度指定DCT的逻辑位置。

·最佳语言，当前最佳语言。

此调用返回一个指示在服务API时所遇到的任何错误的状态。

2.3. SysRequestStatus

用来取得当前转换器系统状态。此调用返回一个指示在服务API 时所遇到的任何错误的状态。

2.4. SysRequestTimestamp

用来取得具有到秒的当地时间、当前日期、时区信息等的一系 统时间戳记。此调用返回一个指示在服务API时所遇到的任何错误 的状态。

2.5. SysTimestamDRe2ister

用来记录客户对自发的系统时间戳记的更新。系统时间戳记指 示精确到秒的当地时间，包括当前日期、星期几、时区信息等。系 统时间戮记从头端接收，并非同步地转送给客户。API返回的状态 指示将阻碍API被服务的任何错误。如果起始的调用没有错误，那 么无论何时收到一个新的系统时间戳记，将调用由用户定义的调回 函数，传递用户分配的回呼数据结构。

2.6. SysTimestampCancel

用来取消由SysTimestampRegister API建立的系统时间更新 的记录，此调用返回一个指示在服务API时所遇到的任何错误的状 态。

2.7. SysSetRFOutChannel

用来设定射频(RF)调变器硬件的输出频道号码。此调用返回 一个指示在服务API时所遇到的任何错误的状态。

2.8. SysControlOnOffState

用来设定终端机为开或关状态。此调用返回一个指示在服务API 时所遇到的任何错误的状态。

2.9. SysContrQlACRelay

用来在不同公用程序的出口模式之间切换。终端机有能力控制 公用程序出口在切换(自动模式)控制和连续开/连续关模式之间 的操作。当终端机在自动模式中时，公用程序出口在终端机为ON状 态中时有效力，而在终端机为OFF状态时没有效力。手动操作模式 允许应用将公用程序(U.S.类型)出口设定为连续开或连续关。此 调用返回一个指示在服务API时所遇到的任何错误的状态。

2.10. SysControlRFBypass

用来选择RF信号是穿过终端机还是绕过终端机。这个特性允许 更友好地操作有线备妥(cable-ready)的电视和录象机。此特征复 制在许多录象机中出现的电视/录象机开关。关掉终端机的动作将产 生绕过的情况。有线操作员可覆盖所选择的状态。可使用 SysRequestStaius()确定实际状态。此调用返回一个指示在服务 API时所遇到的任何错误的状态。

2.11. SysSetLanauage

用来设定用户的最佳语言。此调用返回一个指示在服务API时 所遇到的任何错误的状态。

3.自发事件指示API

3.1. UsolEventRegister

用来记录用户的自发事件指示讯息。由API返回的状态指示将 会阻止API被服务的任何错误。如果初始的调用没有错误，那么无 论何时发生一个用户记录的新事件，将调用用户所定义的调回函数， 传递用户配置的回呼数据结构。

3.2 UsolEventCancel

用来取消由UsolEventRegister API建立的自发事件指示的记 录。此调用返回一个指示在服务API时所遇到的任何错误的状态。

4.基线保密接口API

4.1.目的&范畴

这个单元试图通过定义一组API函数来定义一BPI密码服务接 口，以支持用于DOCSIS驱动程序的BPI键管理(BPKM)协议。这些 API将不负责BPKM中授权和通信量(traffic)加密键(TEK)状态 机的实现。

4.2.安全目的和目标

API函数被定义成只提供上述两种状态机的密码服务。那些密 码服务将包括下列各项：

·向DOCSIS驱动程序提供有线调制解调器的RSA公用密钥。

·对DOCSIS驱动程序所提供加密授权密钥执行RSA解密操作。 有二种独立的模式，其中GI BPI API可包括在代码中。

如果DOCSIS驱动程序具有导出所有必需的剩余密钥的能力， 则将解密的授权密钥返回到DOCSIS驱动程序。如果选择了这个模 式，只有需要两种BPI APl被包含在代码中(CMExportID， CMAuthKey)。

不会将解密的授权密钥返回到DOCSIS驱动程序。如果选择了 这个模式，那么需要五种BPI API被包含在代码中(CMExport ID， CMDeriveKeys，CMGenerateHMAC CMVerifyHMAC，CMDecryptTEK)。

·根据解密的授权密钥产生键加密密钥(KEK)，但将不返回KEK 到DOCSIS驱动程序。

·产生逆流基于散列的讯息认证码(HMAC)密钥，但将不返回 逆流HMAC密钥到DOCSIS驱动程序。

·认证密钥请求讯息，并返回逆流HRAC密钥的讯息摘要到DOCUS 驱动程序。

·产生顺流基于散列的讯息认证码(HMAC)密钥，但将不返回 顺流HMAC密钥到DOCSIS驱动程序。使用顺流HMAC密钥使顺流HMAC 有效。

·使用KEK解密经DES加密的通信量加密密钥(TEK)，并返回 TEK到DOCSIS驱动程序。

4.3.定义，首字缩语，缩写

BPI基线保密接口

BPKM基线保密密钥管理协议

CM有线调制解调器

CMTS有线调制解调器终端系统

CBC密码区块链接

CSP接口密码服务提供者

DES数据加密标准算法(FIPS-46，FIPS-46-1，FIPS-74， FIPS-81)

DOCSS通过有线安全系统的数据

DOCSIS通过有线服务接口规范的数据

HMAC基于散列(hashed-based)的讯息认证码

KEK键加密密钥

RSA Rivest Shamir Adleman，公用密钥加密技术

SMA保密散列算法

SID服务识别

TEK通信量加密密钥

4.4.讯息支持函数

CMExport ID

用来从BPI加密服务提供者(CSP)输出CM-识别属性。CM-识 别属性用在授权请求和密钥请求讯息中。

CMAuthKey

用来解密在授权回覆讯息中发送出的授权密钥(Auth密钥)， 然后将解密的Auth密钥传回到调用者。当从一CMTS收到一授权回 覆讯息时，这个函数将立刻被DOCSIS驱动程序调用。如果调用的实 体使用这个API，那么调用的实体将需要导出键加密密钥(KEK)， 逆流HMAC密钥(HMAC_KEY_U)，和顺流HMAC密钥(HMAC_KEY_D)。 这个API将被用在基于ASTB的WinCE中。通过客户需求来确定是否 要包括这个API或CMDeriveKeys API。根据这些需求，一个或其他 的API将会是建立那个系统软件的编译的一部分。

CMDeriveKeys

用来导出授权密钥(Auth密钥)，键加密密钥(KEK)，逆流HMAC 密钥(HMAC_KEY_U)，和顺流HMAC密钥(HMAC_KEY_D)。当从一CMTS 收到一授权回覆讯息时，这个函数将立刻被DOCSIS驱动程序调用。 BPI CSP将维持一个有效的授权密钥和导出的相关密钥。Auth密钥， KEK，HMAC_KEY_U，和HMAC_KEY_D对DOCSIS驱动程序来说将是不 可用的。在DOCSIS驱动程序没有能力从Auth密钥得出所有需要的 密钥时，使用这个API。

CMGenerateHMAC

用来为密钥请求讯息(从CM到CMTS的一逆流讯息)生成一个 加密(keyed)的讯息摘要(HMAC-Digest)，如BPI规范中所定义。 HMAC-Digest将被返回到DOCSIS驱动程序。

CMVerifyHMAC

用来供CM认证密钥回覆，密钥拒绝，和TEK无效讯息。

CMDecryptTEK

用来供CM解码SA-参数属性中的TEK-密钥子属性，如BPI规范 的第4.2.1.5节中所定义。这个API在每一次被存取时只产生一 个清楚的TEK。为了使有线调制解调器(CM)能符合需求，以使初 级和次级TEK可用，DOCSIS驱动程序需要将这个API调用两次。 DOCSIS驱动程序将跟踪对API的哪个调用是用于初级TEK的，而哪 一个调用是用于次级TEK的。

5.下载程序API

5.1.概观

下载程序提供用于应用程序和AppOS的API，以管理从头端 或是经由API调用载入到DCT5000中的对象。

5.2. FindFirstObject

用来搜寻当前载入的对象并返回相关信息。它能连同 FindNextObject API一起使用，以搜寻用于符合指定标准的所有 对象的对象目录。此调用返回一个指示在服务API时所遇到的任何 错误的状态。

5.3. FindNextObject

用来搜寻下一当前载入的对象并返回相关信息。它连同 FindFirstObject API一起使用，以搜寻用于符合指定标准的所有 对象的对象目录。FindFirstObject调用在此调用能被用于连续搜 寻之前，必须已经返回一成功的结果。在FindNextObject上所指定 的所有参数，必须与来自上一次FindNextObject或FindFirstObject 调用的参数相符。一旦返回未找到的情况，就必须使用 FindFirstObject开始新的搜寻。此调用返回一个指示在服务API 时所遇到的任何错误的状态。

5.4. RegisterObjectManager

由App OS使用以记录为对象的管理器。无论何时被管理对象的 状态改变或请求改变(例如，删除来自头端的讯息)，下载程序将通 过回呼来通知对象管理器。此调用返回一个指示在服务API时所遇 到的任何错误的状态。

5.5 WriteCompleteObject

用来在一基本(atomic)操作中创建和写入一个对象。在对象 已被完全载入一存储器缓冲区时，这是很有用的。此调用返回一个 指示在服务API时所遇到的任何错误的状态。

5.6. CreateObject

用来准备一个将被写到存储器中的对象，包括分配给它的空间。 这对在用于该对象的所有数据目前在存储器中不可用时(见 WriteCompleteObject)创建一个对象是很有用的。此调用返回一个 指示在服务API时所遇到的任何错误的状态。

CreateObject，WriteObject，和CloseObject的组合，可用来 创建一个不是在一个写操作(如以WriteCompleteObject)中写入 的所有对象都立刻可用的对象。调用程序负责跟踪已经写入的对象 的区域。如果在对象的所有部分被写入之前发出一个CloseObject， 则对象的未写部分的内容可能包含随机值(即，WriteObject未尝 试跟踪哪些区域已被写入)。如果尝试在已经通过一先前的 WriteObject写入的数据上写入新数据，则或者新数据被成功地储 存在旧数据上(如果是在RAM中)或者发生写错误(如果是在闪速 存储器中)。

5.7 WriteObject

用来将对象的一部分写入到存储器。此调用返回一个指示在服 务API时所遇到的任何错误的状态。

5.8. CloseObject

用来结束将一指定对象写入对象存储器。此调用返回当服务API 时，指示所遇到的任何的一状态。

5.9 ReadObject

用来获得指定对象的内容。此调用返回一个指示在服务API时 所遇到的任何错误的状态。

5.10. DeleteObject

用来从存储器中删除一个或更多对象。此调用返回一个指示在 服务API时所遇到的任何错误的状态。

5.11. PurgeObject

用来从存储器中删除一个或更多对象。此调用返回一个指示在 服务API时所遇到的任何错误的状态。

5.12.调回函数

对象管理器回呼

根据在与下载对象有关的DCT5000中发生的活动，对象管理器 可从下载程序接收回呼。当一重要的事件发生时，利用一个指向回 呼结构的指针来调用对象管理器，所述回呼结构识别事件和事件所 涉及的对象。回呼在事件发生时发出，因此在任何特定时间可能有 多于一个的未决回呼。该结构都是由下载程序配置和取消配置的。

6.购买和授权API

6.1. PurchaseProgramImmediate

请求购买当前在所调谐的VCN上的节目。指定的VCN必须符合 当前所调谐的VCN，而ServiceStatus应指示该节目是可购买的。

6.2. PurchaseProgram

请求购买当前在所调谐的VCN上的节目。指定的VCN必须符合 当前所调谐的VCN，而ServiceStatus应指示该节目是可购买的。

6.3. CancelProgramPurchase

请求取消购买指定的节目。需要取消ID和VCN来取消一先前购 买的节目。不一定要调谐到指定VCN来取消购买。取消ID用来唯一 地识别要取消的购买，而VCN被用作次要的对照参考。注意对将要 实现的请求来说，购买必须是“可取消的”。如果取消的时间落在可 取消的窗口内，且头端已配置终端机允许取消，则购买是可取消的。 可取消的窗口定义(近似)为在交互式选片付费(IPPV)窗口开始 和免费预览结束(即，IPPV开始十免费预览期间)之间的时间。

6.4. PurchasePackageImmediate

请求购买当前所调谐的VCN上由PackageName所指示的节目包。 指定的VCN必须与当前调谐的VCN相符，而ServiceStatus应指示 该节目包是可购买的。

6.5. PurchasePackage

请求购买当前所调谐的VCN上由PackageName所指示的节目包。 所述的VCN必须与当前调谐的VCN相符，而ServiceStatus应指示 该节目包是可购买的。

6.6. CancelPackagePurchase

请求取消所指定的成包服务之购买。需要取消ID和VCN来取消 一先前所购买的节目。不一定要调谐到指定的VCN来取消购买。取 消ID用来唯一地识别要取消的购买，而VCN用作第二对照参考。注 意对要实现的请求来说，购买必须是“可取消的”。如果取消的时间 落在可取消的窗口之内，且头端已配置终端机允许取消，则购买是 可取消的。可取消的窗口被定义(近似)为在IPPV窗口开始和免费 预览结束(即，IPPV开始+免费预览期间)之间的时间。

6.7. GetPendingPurchases

请求所有未决的购买。通常，在系统启动之后利用这个函数， 以判定哪些购买是未解决的。然后用户可使用 PurchaseCallbackRefresh API为每一未决购买提供一调回函数。 这个API提供所有类型的购买，包括模拟节目，数字节目和数字节 目包。在每一情况中只有某些参数是有效的。

6.8. PurchaseCallbackRefresh

用户在系统启动之后使用这个API来更新用于一指定节目或节 目包购买的购买调回函数指针。

7.密码API

7.1. SettopSetPassword

设定所指示的槽之密码。密码槽PARENTAL_PASSWORD用作双亲 控制密码，而槽PURCHASE_PASSWORD用作购买的密码。根据终端机 的型式，可提供额外的槽作为一般的密码。一个密码是 PASSWORD_LENGTH个字符构成的阵列。此调用返回一个指示在服务 API时所遇到的任何错误的状态。

7.2. SettopCheckPassword

确认用于特定槽的指示密码。密码槽PARENTAL_PASSWORD用作 双亲控制密码，而槽PURCHASE_PASSWORD用作购买的密码。根据终 端机的型式，可提供额外的槽作为一般的密码。如果密码已被清除 或从未设定，则任何密码都将匹配。此调用返回一个指示在服务API 时所遇到的任何错误的状态。

8.初始化API

8.1. StartGITV

启动GITV。应用操作系统是与这个API接口的外部客户。此调 用返回一个指示在服务API时所遇到的任何错误的状态。

8.2. IsGITVReadV

确认GITV正在运行。应用操作系统是与这个API接口的外部客 户。此调用返回一个指示在服务API时所遇到的任何错误的状态。

9.平台配置API

9.1. GetSDRAMInfo

检查SDRAM的有效性，返回安装在顶设中SDRAM的起始地址、 大小和有效性。此调用返回一个指示在服务API时所遇到的任何错 误的状态。

9.2. GetEndianStatus

返回在初始化时CPU的ENDIANness。

9.3. GetNVMEMInfo

检查NVMEM的有效性，返回安装在顶设中NVMEM的起始地址、 大小和有效性。此调用返回一个指示在服务API时所遇到的任何错 误的状态。

9.4. GetSettopIDs

检索关于顶设的包括平台ID、制造商、产品系列和型号信息的 信息。此调用返回一个指示在服务API时所遇到的任何错误的状态。

9.5. GetTSIInfo

除了DOCSIS、以太网、1394、USB、和顶设的MAC地址之外， 检索处理器、桥接器类型和顶设的振荡速度(crystal speed)。此 调用返回一个指示在服务API时所遇到的任何错误的状态。

9.6. GetMemorvInfo

检索顶设的各种存储器组成之存储器大小信息。此调用返回一 个指示在服务API时所遇到的任何错误的状态。

9.7. GetCableModemInfo

检索有线调制解调器和DOCSIS选择项信息。此调用返回一个指 示在服务API时所遇到的任何错误的状态。

9.8. GetMiscellaneousInfo

检索顶设使用中的输出频道的类型。此调用返回一个指示在服 务API时所遇到的任何错误的状态。

9.9. Get1394InfO

检索安装在顶设中1394接口的有关信息。此调用返回一个指示 在服务API时所遇到的任何错误的状态。

9.10. GetEthernetInfo

检索安装在顶设中以太网接口的有关信息。此调用返回一个指 示在服务API时所遇到的任何错误的状态。

9.11. GetParallelPortInfo

检索关于安装在顶设中的并行端口的信息。此调用返回一个指 示在服务API时所遇到的任何错误的状态。

9.12. GetHardDriveInfo

检索当前安装在顶设中的硬磁盘机(hard drive)的类型。此 调用返回一个指示在服务API时所遇到的任何错误的状态。

9.13. GetPlatformInfo

检索当前在顶设中运行的平台的版本和平台的类型。此调用返 回一个指示在服务API时所遇到的任何错误的状态。

10.诊断API

10.1. GetErrorStatus

在发生了错误时，指示错误的类型。因为顶设可以是下列各项 之一：引导装入程序(bootloader)、基本平台或本地程序组(native suite)，编码方案和解译(interpretation)可依每一平台的不同 而不同。这个API不支持引导装入程序误码。这些可在启动数据库 中发现。这个调用返回一个指示在服务API时所遇到的任何错误的 状态。

10.2. GetPurchasesStatus

GetpurchaseStatusdiaa～nostic包含在顶设中与IPPV购买有 关的信息。这个调用返回一个指示在服务API时所遇到的任何错误 的状态。

10.3. GetOutputPortStatus

输出端口状态包含与终端机输出或再调制(Remod)端口有关的 信息。输出/Remod端口是从终端机到用户电视机的接口。这个调 用返回一个指示在服务API时所遇到的任何错误的状态。

10.4. GetLastReset

GetLastReset指示以GPS秒为单位的最后重设时间、所发生的 重设类型和最后致命错误记录项。

10.5. GetVCTID

指示用于驻存在顶设中的虚拟频道表的VCT ID。

10.6. GetOOBStatus

指示OOB流组成的状态。这个调用返回一个指示在服务API时 所遇到的任何错误的状态。

10.7. GetInbandStatus

指示当前INBAND多路复用(multiplex)的状态。

10.8. GetUnitAddresses

指示分派给顶设的单元地址。这个调用返回一个指示在服务API 时所遇到的任何错误的状态。

10.9. GetCurrentChannelStatus

指示最后尝试的主要服务取得的状态。

10.10. GetRenewableSecuritvStatus

可更新安全性的概念改变以支持DES解密或原始的条件式存 取。可更新的安全槽有一PCMCIA II型的类型参数，包含2MB的安 全非易失性存储器，支持加密板上密钥的生成和加密以及80兆比特 /秒的DES解密速率。

10.11. GetRFModemStatus

指示安装在顶设中的RF调制解调器的传输状态。这个调用返回 一个指示在服务API时所遇到的任何错误的状态。

10.12. GetCodeModuleStatus

指示载入到闪速存储器中的任何固加的状态以及安装在顶设中 的非易失性码的所有版本。

10.13. GetMemoryStatus

指示顶设的存储器配置。这个调用返回一个指示在服务API时 所遇到的任何错误的状态。

10.14. GetDOCSISStatus

这个API用来从App OS检索DOCSIS诊断信息，供在屏幕上诊 断或返回报告。此调用返回一个指示在服务API时所遇到的任何错 误的状态。

10.15. GetUSBStatus

返回USB端口和任何被安装的设备的状态。此调用返回一个指 示在服务API时所遇到的任何错误的状态。

10.16. Getl394Status

返回1394端口的状态。此调用返回一个指示在服务API时所遇 到的任何错误的状态。

10.17. GetEthernetStatus

返回以太网端口的状态。此调用返回一个指示在服务API时所 遇到的任何错误的状态。

10.18. GetParallelStatus

返回并行端口的状态。此调用返回一个指示在服务API时所遇 到的任何错误的状态。

10.19. GetIRBlasterStatus

返回IR加速器(blaster)(发射器)的状态。此调用返回一个 指示在服务API时所遇到的任何错误的状态。

10.20. GetIRKeyboardStatus

返回IR键盘的状态。这个调用返回一个指示在服务API时所遇 到的任何错误的状态。

10.21. GetIRRemoteStatus

返回IR遥控器的状态。此调用返回一个指示在服务API时所遇 到的任何错误的状态。

10.22. GetSmartCardStatus

返回智能卡的状态。此调用返回一个指示在服务API时所遇到 的任何错误的状态。

10.23. GetHardDriveStatus

返回硬磁盘机的状态。此调用返回一个指示在服务API时所遇 到的任何错误的状态。

10.24. GetSettopGraphicsStatus

返回顶设图形系统的状态。此调用返回一个指示在服务API时 所遇到的任何错误的状态。

10.25. GetNetworkAdapterStatus

除了有关的参数及/或状态之外指示一网络适配器是否可用。

10.26. GetResourceAuthorizationStatus

这个API返回顶设中每一资源的资源授权状态。

10.27. GetMPEGLockStatus

这个API返回MPEG视频和音频流、以及节目时钟参考(PCR) 的锁定状态。

11.音频服务器API

11.1. AudioControlModeSelect

音频控制模式选择API调用允许一客户设定DCT5000的音频输 出模式。选择包括：环绕音场，立体声，和单声道。

11.2. AudioControlVolumeModeSelect

音频控制音量模式选择API调用允许一客户设定或调整GITV的 音量单元定义。这个API调用与服务类型、模拟或数字无关。

11.3. AudioControlLoopThruSelect

音频回路通过控制API调用允许一客户使能或解除使能音频回 路通过。

-使能的回路通过(开)：顶设在基带连接器上输出外部声源。

-解除使能的回路通过(关)：顶设将外部声源静音。

11.4. AudioControlAC3CompressionSelect

AC-3压缩控制API调用允许一客户设定AC-3动态范围压缩模 式：无压缩，轻度压缩或重度压缩。

11.5. AudioControlSAPSelect

如果可用，SAP选择API调用允许一客户在一模拟服务当中选 择第二音频节目(SAP)声源。这个操作只适用于一个模拟服务。具 体地，顶设只允许在取得或调谐到一具有SAP的模拟服务时，选择 SAP。

11.6. AudioControlSPDIFSelect

索尼菲利浦数字接口格式(SPDIF)选择API调用允许一客户选 择顶设的SPDIF或越过模拟音频输出路径(remod和基带)的数字 音频输出路径。

顶设提供三种SDPIF输出模式：

-SPDIF使能：顶设在SPDIF上输出音频，基带和remod音频是 不可用的。音频输出格式包括：向下混合的环绕音场(l+r)，立体 声，和单声道。

-有完整AC-3输出的使能SPDIF：顶设直接在SDNF上输出AC-3。 AC-3输出只适用于数字服务。为模拟服务而在SPDIF上输出立体声 或单声道。需要一个来自顶设的AC3解码器顺流。

-SPDIF解除使能：顶设在模拟输出路径(remod，和基带)上 输出音频。音频输出格式包括：向下混合的环绕音场(l+r)，立 体声，和单声道。

11.7. AudioVolume(基本控制)

这个API调用允许一用户调整顶设的主音量。顶设调整左和 右两个频道输出。

11.8. AudioVolumeBalance(平衡控制)

这个API调用允许一用户以左和右频道值分别调整顶设的主音 量。

11.9. AudioMute

选择主音频静音模式开或关。

11.10. AudioTvVolume(基本控制)

这个API调用允许一用户调整电视声源的相对音量。这个调用 调整左和右两个频道输出。

11.11. AudioTvVolumeBalance(平衡控制)

电视平衡音量控制API调用允许一用户以左和右频道值分别 调整电视声源的相对音量。

11.12. AudioTvMute

选择电视音频静音模式开或关。

11.13. AudioLocalVolume(基本控制)

这个API调用允许一用户调整本地声源(PCM，声波等)的相对 音量。这个调用调整左和右两个频道输出。

11.14. AudioLocalVolumeBalance(平衡控制)

这个API调用允许一用户以左和右频道值分别调整本地声源 (PCM，声波等)的相对音量。

11.15. AudioLocalMute

选择本地音频静音模式开或关。

11.16. AudioStatus

GITV音频服务器提供一个API调用来报告音频状态。

12.视频服务器API

12.1. VideoTvBlank

选择电视图象空白模式开或关。

12.2. VideoControlTvBlankModeSelect

这个API调用控制如何通过顶设使电视图象空白。定义了默认 值以使图象如同在引入调用之前那样操作。

12.3. VideoStatus

GITV视频服务器提供一个API调用来报告视频状态。

13.资源授权

13.1. ResourcePermissionCheck

用来获得资源的许可状态。当在通用(global)模式中使用时， API以resourceID为一输入参数，并尝试在资源/层(tier)/状态 表中查找该ID。如果找到该ID，许可状态被返回到调用程序。如果 找不到该ID或该表不存在，API将返回一错误。如果API在应用模 式下使用，调用程序必须包括对象ID和对象版本指针作为额外的输 入参数。在这种情况下，API将确认对ASTB的通用访问并确认该对 象已经访问了该资源。

13.2. ResAuthStatusRegister

用来记录用户以便如果资源的授权状态改变时接收一通知。由 API返回的状态指出将阻碍API被服务的任何错误。一旦对一特定 的资源进行记录，则无论该资源的授权状态何时改变，将利用回呼 机构通知用户。

13.3. ResAuthStatusCancel

用来取消由ResAuthStatausRegister API所建立的对一资源授 权状态指示的记录。此调用返回一个指示在服务API时所遇到的任 何错误的状态。

14.高分辨率流通API

14.1. GITV_Get13945CData

这个函数被调用以获得含有DTCP数据的受保护闪速数据块。

14.2. GITV_SET1394NVRAMData

这个函数被调用以写入含有DTCP数据的非易失性随机存取存储 器(NVRAM)数据块。

14.3. GITV_Get1394NVRAMData

这个函数被调用以读出含有DTCP数据的NVRAM数据块。

14.4. GITV_GetTextDescriptor

在1394总线上提供对顶设的字母数字描述。

14.5. GlTV_DTVConnectStatus

定义DTV连接的当前状态。

14.6. GITV_Get13945CSRM

这个函数被调用以获得1394 5C SRM(系统可更新性讯息(System Renewabiliiy Message))。这些讯息包含不再适应5C的设备的证明 废止清单。这用来确保系统的长期完整性。SRM格式在日期为4/ 12/99的“数字传输内容保护规范”第1卷的修订版1.0中的1394 5C 规范的第7章中有所描述。

现在应理解本发明提供一种软件接口，该接口使电视顶设中间 软件和操作系统(Os)软件能够控制用户电视终端机中的核心顶设 系统软件并与之交互作用，以利于提供想要的数字电视服务，包括 服务取得(例如，选片付费电影的取得)、系统信息管理、顶设配置 和控制、轮询的返回路径、包括认证和授权的下载能力、和非易失 性存储器管理。

而且，此软件接口是可在一允许核心顶设软件能够与多个顶设 操作环境相容的体系结构中操作的。通过此软件体系，不必通过为 每一环境重写特定的程序码或透过一抽象层，将此核心软件移植到 不同的操作环境。取而代之的，一个独特的设备驱动程序对驱动程 序模型接口与一克服可携性问题的核心摘要组成一起提供，并在体 系结构中的各层之间提供一规则的(clean)接口。

本发明可使用对象导向技术，例如C++或Java程序实施，虽 然本发明绝不限制于这样的一种实施。

在此处描述的组成组合为顶设软件提供了一种基础，以使一高 级机顶盒能够实施高级特征。每一组成提供一高级顶设终端机所必 需的必要函数。本发明的新体系结构提供核心顶设软件对其他操作 环境重复使用和可携性的优点。藉此允许广为了解和先前已测试过 的软件组成的重复使用。此体系结构也能够迅速而直接地提供在其 他操作环境的实施。

虽然本发明已结合各种特定实施例进行了描述，但应了解各 种改编和修改可于其中完成而不离开本发明在申请专利范围中所陈 述的范畴。