Page 13

CWA 15748-5:2008

dwGuidLights [...]

指定指示灯的显示状态。指示灯的类型说明如下。厂商指定的指示灯都是从数组的尾端开始确定的。最大的指示灯指定为WFS_PTR_GUIDLIGHTS_MAX。

指定指示灯的显示状态为WFS_PTR_GUIDANCE_NOT_AVAILABLE、WFS_PTR_GUIDANCE_ OFF或下列标志组合，这些标志由一个B型加上一个C型组成，C型可选。 值

WFS_CDM_GUIDANCE_NOT_AVAILABLE WFS_CDM_GUIDANCE_OFF

WFS_CDM_GUIDANCE_SLOW_FLASH WFS_CDM_GUIDANCE_MEDIUM_FLASH WFS_CDM_GUIDANCE_QUICK_FLASH WFS_CDM_GUIDANCE_CONTINUOUS WFS_CDM_GUIDANCE_RED WFS_CDM_GUIDANCE_GREEN WFS_CDM_GUIDANCE_YELLOW WFS_CDM_GUIDANCE_BLUE WFS_CDM_GUIDANCE_CYAN

WFS_CDM_GUIDANCE_MAGENTA WFS_CDM_GUIDANCE_WHITE

涵义

不可使用状态 灯关闭状态 灯慢速闪动 灯中速闪动 灯快速闪动

灯连续开启（常亮） 红色灯 绿色灯 黄色灯 蓝色灯 蓝绿色灯 品红色灯 白色灯

类型 A A B B B B C C C C C C C

wDevicePosition

时，fwDevice可以拥有上述规定的任何值（包括WFS_PTR_DEVONLINE或WFS_PTR_DEVOFFLINE）。如果设备不在其正常的工作位置（例如：WFS_PTR_DEVICEINPOSITION），那么，媒介也许没有通过正常接口到位。

此参数可能为下列值之一：

值

WFS_CDM_DEVICEINPOSITION WFS_CDM_DEVICENOTINPOSITION WFS_CDM_DEVICEPOSUNKNOWN WFS_CDM_DEVICEPOSNOTSUPP

usPowerSaveRecoveryTime

设定从当前的省电模式恢复到正常的业务状态下实际所需要的秒数。如果不是省电模式或者没有节电控制提供支持，此值为零。

错误代码： 此命令仅产生定义在[参考一]的一般错误代码。

注释： 应用程序所依赖的参数lpszExtra可能没有设备或与厂商无关。

在此情况，与设备间的通讯将会丢失，当设备被移除时fwDevice将报告WFS_CDM_ DEVPOWEROFF。当通讯意外中断时候将报告WFS_CDM_DEVHWERROR。 所有其他结果将包含一个基于下列规则的值： 1. 报告值未知

2. 报告值为一般H/W错误 3. 报告值为最后已知值

涵义

设备处于正常操作位置或固定位不能被移动 该设备被从正常操作位置移除。

由于硬件故障或其他情况，无法确定设备位置 该物理设备不具备检测位置的能力

指定设备的位置。设备位置值与fwDevice值无关，例如，当设备位置报告为WFS_PTR_DEVICENOTINPOSITION

Page 14

CWA 15748-5:2008

4.2 WFS_INF_CDM_CAPABILITIES

描述： 此命令用于检索CDM的能力。它也返回供应商的具体能力信息。暂存和传输通道被视为单独的部分。某些

设备可以通过传输通道把钞币从钞箱移动到暂存。同样某些设备可以回收传输通道和暂存的钞币到钞箱。

输入参数：无

输出参数：LPWFSCDMCAPS lpCaps; typedef struct _wfs_cdm_caps { WORD wClass; WORD fwType; WORD wMaxDispenseItems; BOOL bCompound; BOOL bShutter; BOOL bShutterControl; WORD fwRetractAreas; WORD fwRetractTransportActions; WORD fwRetractStackerActions; BOOL bSafeDoor; BOOL bCashBox; BOOL bIntermediateStacker; BOOL bItemsTakenSensor; WORD fwPositions; WORD fwMoveItems; WORD fwExchangeType; LPSTR lpszExtra; DWORD dwGuidLights[WFS_CDM_GUIDLIGHTS_SIZE]; BOOL bPowerSaveControl; BOOL bPrepareDispense; } WFSCDMCAPS, *LPWFSCDMCAPS;

wClass

设定逻辑服务类为WFS_SERVICE_CLASS_CDM。 fwType 提供CDM的类型为下列值之一：

值

WFS_CDM_TELLERBILL WFS_CDM_SELFSERVICEBILL WFS_CDM_TELLERCOIN

涵义

CDM是一个钞票柜员机

CDM是一个自助服务钞票的取款机 CDM是一个硬币柜员机

WFS_CDM_SELFSERVICECOIN CDM是一个自助服务硬币的取款机 wMaxDispenseItems

提供单分配操作的最大能分配钞币数。如果没有限制使用此值将为零，在此情况下，如果尝试分配比硬件所允许的钞币数更多，SP将实施一系列单独分配操作。[参照第八节，单步取款命令流程]

bCompound

设定CDM是否为复合设备。如果CDM是一个以计算机集成制造的复合设备，那么这种组合称为循环。在此情况，没有存款钞箱通过CDM提供的相关接口。CDM接口将提供共享回收或拒绝钞箱和回收钞箱的信息。

bShutter

设定命令WFS_CMD_CDM_OPEN_SHUTTER和WFS_CMD_CDM_CLOSE_SHUTTER是否被支持。

Page 15

CWA 15748-5:2008

bShutterControl

如果为TURE， 将由SP提供钞门的控制。如果设置为FALSE，钞门必须通过应用程序使用WFS_CMD_CDM_OPEN_SHUTTER和WFS_CMD_CDM_CLOSE_SHUTTER命令而被明确的控制。如果设备没有钞门此值恒为TRUE。此值适用于所有的钞门和输出位置。

fwRetractAreas

设定钞币可能通过下面的标志组合被回收： 值

WFS_CDM_RA_RETRACT WFS_CDM_RA_TRANSPORT WFS_CDM_RA_STACKER WFS_CDM_RA_REJECT WFS_CDM_RA_ITEMCASSETTE WFS_CDM_RA_NOTSUPP

值

WFS_CDM_PRESENT WFS_CDM_RETRACT WFS_CDM_REJECT WFS_CDM_ITEMCASSETTE WFS_CDM_NOTSUPP

fwRetractStackerActions

设定可能已执行被回收到堆栈的动作的钞币。如果设备没有回收能力，此参数将为 WFS_CDM_NOTSUPP。否则，为下列标志的组合： 值

WFS_CDM_PRESENT WFS_CDM_RETRACT WFS_CDM_REJECT WFS_CDM_ITEMCASSETTE WFS_CDM_NOTSUPP

bSafedoor

设定命令WFS_CMD_CDM_OPEN_SAFE_DOOR是否被支持。 bCashBox

此字段仅适用于CDM类型为WFS_CDM_TELLERBILL和WFS_CDM_TELLERCOIN。 它指定是否显示已分配的现金箱。

涵义

钞币可能被呈现

钞币可能被回收到回收钞箱 钞币可能被拒绝到拒绝执行

钞币可能被回收到机芯，即可以从机芯分配 CDM没有从堆栈回收的功能 涵义

钞币可能被呈现

钞币可能被回收到回收钞箱 钞币可能被拒绝到拒绝执行

钞币可能被回收到机芯，即可以从机芯分配 CDM没有从传输通道回收的功能

fwRetractTransportActions

设定可能已执行被回收到传输通道的动作的钞币。如果设备没有回收能力，参数为 WFS_CDM_NOTSUPP。此参数可以为下列标志的组合：

涵义

钞币可能被回收到回收钞箱 钞币可能被回收到传输通道 钞币可能被回收到暂存 钞币可能被回收到拒绝钞箱

钞币可能被回收到机芯，即可以从机芯分配 CDM没有回收功能

Page 16

CWA 15748-5:2008

bIntermediateStacker

bItemsTakenSensor

设定CDM是否能侦测到钞币在出口位被客户取走。如果为TRUE，SP将产生一个附加的WFS_SRVE_CDM_ITEMS_TAKEN事件。

fwPositions

设定CDM的输出位。可以是下列标志的组合： 值

WFS_CDM_POSLEFT WFS_CDM_POSRIGHT WFS_CDM_POSCENTER WFS_CDM_POSTOP WFS_CDM_POSBOTTOM WFS_CDM_POSFRONT WFS_CDM_POSREAR

fwMoveItems

设定CDM的移动钞币位。可以是下列标志的组合： 值

WFS_CDM_FROMCU WFS_CDM_TOCU

fwExchangeType

设定CDM所支持的钞箱激活类型。可以是下列标志的组合： 值

WFS_CDM_EXBYHAND lpszExtra

指向厂商特有或任何其它扩展信息的一个列表。返回信息为一系列“键=值”字符串以便SP进行轻松扩展。每一个字符串都是以空字符NULL结束的，最后一个字符串以两个空字符NULL结束。一个空列表可通过一个空指针或两个连续的空字符NULL来表示。

dwGuidLights [...]

指定指示灯的显示状态。指示灯的类型说明如下。厂商指定的指示灯都是从数组的尾端开始确定的。最大的指示灯指定为WFS_PTR_GUIDLIGHTS_MAX。

涵义

CDM支持手动添加物品到钞箱或更换钞箱 涵义

CDM可以通过传输通道把钞币从钞箱移动到暂存 当暂存上有钞币的时候， CDM 能撤回钞箱的钞币

涵义

CDM 有一个左边的输出位置。 CDM 有一个右边的输出位置。 CDM 有一个中间的输出位置。 CDM 有一个上面的输出位置。 CDM 有一个下面的输出位置。 CDM 有一个前面的输出位置。 CDM 有一个后面的输出位置。

设定CDM是否支持堆栈钞币被移动到出口位之前的中间位置。如果为TRUE，WFS_CMD_CDM_DISPENSE命令的bPresent参数可以设置为FALSE。

WFS_CDM_TOTRANSPORT 当暂存上有钞币的时候， CDM 能撤回传输通道的钞币

WFS_CDM_EXTOCASSETTES CDM支持从一个钞箱到另一个钞箱移动钞币