WOSA／XFS 3.10 中文版 05

Page 9

CWA 15748-5:2008

3. 参考资料

1. XFS 应用程序接口（API）， 服务提供接口（SPI），程序员参考3.10版 2. ISO 4217 位于：http://www.iso.org 3. XFS 存款模块设备接口类，程序员参考3.10版

Page 10

CWA 15748-5:2008

4. 信息命令

4.1 WFS_INF_CDM_STATUS

描述： 此命令用于获取CDM的状态。它也返回厂商特殊状态信息。 输入参数： 无

输出参数： LPWFSCDMSTATUS lpStatus;

typedef struct _wfs_cdm_status {

WORD fwDevice; WORD fwSafeDoor; WORD fwDispenser;

WORD fwIntermediateStacker; LPWFSCDMOUTPOS *lppPositions; LPSTR lpszExtra;

DWORD dwGuidLights[WFS_CDM_GUIDLIGHTS_SIZE]; WORD wDevicePosition;

USHORT usPowerSaveRecoveryTime; } WFSCDMSTATUS, *LPWFSCDMSTATUS;

fwDevice

CDM所提供的状态。然而，fwDevice的WFS_CDM_DEVONLINE状态不是取款实现的唯一前提，fwDispenser参数的值也必须有效。在某些版本中，保险箱（fwSafeDoor）的状态也需要考虑。CDM的状态将会是下列值之一： 值

WFS_CDM_DEVONLINE WFS_CDM_DEVOFFLINE WFS_CDM_DEVPOWEROFF WFS_CDM_DEVNODEVICE WFS_CDM_DEVHWERROR WFS_CDM_DEVUSERERROR WFS_CDM_DEVBUSY

WFS_CDM_DEVFRAUDATTEMPT

fwSafeDoor 保险箱提供的状态。此参数将会是下列值之一： 值

WFS_CDM_DOORNOTSUPPORTED WFS_CDM_DOOROPEN WFS_CDM_DOORCLOSED WFS_CDM_DOORUNKNOWN

fwDispenser

提供取款机的逻辑钞箱状态。此参数将会是下列值之一：

涵义

设备没有保险箱或箱门状态报告不被支持。 保险箱打开状态。 保险箱关闭状态。

由于硬件故障或其他情况，箱门状态不能够被确定。 涵义

设备在线。当取款机存在并操作时被返回。

设备离线。(例如管理员按动开关或拉出设备使设备脱机) 设备电源关闭或实际上未接通电源。

无此设备。比如，该类型的自助银行不包含这样的设备或内部没有配置这样的设备

由于硬件错误导致设备无法运行。 设备存在，但人为阻止了设备运行。 设备繁忙，此时无法处理执行命令。 设备存在，但已侦测到一个欺骗尝试。

Page 11

CWA 15748-5:2008

值

WFS_CDM_DISPOK WFS_CDM_DISPCUSTATE WFS_CDM_DISPCUSTOP

涵义

所有钞箱状态正常。

取款机工作正常。一个或者多个钞箱处于将空，空或关闭状态。交易可以通过至少一个钞箱正常进行。

由于钞箱故障无法正常取款。取款机工作正常，但所有的钞箱都处于空或关闭状态，使得交易无法正常进行。也可能是拒绝/回收钞箱满或者不存在所导致，或者是应用程序锁住了钞箱。

WFS_CDM_DISPCUUNKNOWN

fwIntermediateStacker

由于硬件故障或其他情况，钞箱状态不能够被确定。

提供暂存状态。此参数将会是下列值之一： 值

WFS_CDM_ISEMPTY WFS_CDM_ISNOTEMPTY WFS_CDM_ISNOTEMPTYCUST WFS_CDM_ISNOTEMPTYUNK WFS_CDM_ISUNKNOWN WFS_CDM_ISNOTSUPPORTED

lppPositions

指向WFSCDMOUTPOS结构以NULL结尾的指针数组。此结构体所有参数均有效且能够被分配。

typedef struct _wfs_cdm_position

{

涵义 暂存为空。

暂存非空。客户无法使用钞币。

暂存非空。客户正在使用钞币。如果设备在回收暂存上的钞币，可能是由于早先的存款操作。 暂存非空。未知的客户使用情况。

由于硬件故障或其他情况，暂存状态不能够被确定。 物理设备不支持暂存。

WORD fwPosition; WORD fwShutter; WORD fwPositionStatus; WORD fwTransport; WORD fwTransportStatus;

} WFSCDMOUTPOS, *LPWFSCDMOUTPOS;

fwPosition

提供下列值的输出位置。 值

WFS_CDM_POSLEFT WFS_CDM_POSRIGHT WFS_CDM_POSCENTER WFS_CDM_POSTOP

WFS_CDM_POSBOTTOM WFS_CDM_POSFRONT WFS_CDM_POSREAR

涵义

左输出位置 右输出位置 中间输出位置 上输出位置 下输出位置 前输出位置 后输出位置

Page 12

CWA 15748-5:2008

fwShutter

提供下列值的钞门状态。 值

WFS_CDM_SHTCLOSED WFS_CDM_SHTOPEN WFS_CDM_SHTJAMMED WFS_CDM_SHTUNKNOWN WFS_CDM_SHTNOTSUPPORTED

涵义 钞门被关闭 钞门被打开 钞门被干扰

由于硬件故障或其他情况，钞门状态不能够被确定 物理设备没有钞门或其状态报告不被支持

fwPositionStatus

返回可能在输出位上的相关钞币信息。如果设备循环可能，由于支持存款操作，输出位将非空。 参数将会是下列值之一： 值

WFS_CDM_PSEMPTY WFS_CDM_PSNOTEMPTY WFS_CDM_PSUNKNOWN WFS_CDM_PSNOTSUPPORTED

值

WFS_CDM_TPOK WFS_CDM_TPINOP WFS_CDM_TPUNKNOWN WFS_CDM_TPNOTSUPPORTED

fwTransportStatus

返回可能在传输通道上的相关钞币信息。如果设备循环可能，由于支持存款操作，传诵通道将非空。 参数将会是下列值之一： 值

WFS_CDM_TPSTATEMPTY WFS_CDM_TPSTATNOTEMPTY WFS_CDM_TPSTATNOTEMPTYCUST WFS_CDM_TPSTATNOTEMPTY_UNK WFS_CDM_TPSTATNOTSUPPORTED

lpszExtra

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

涵义

传输通道为空 传输通道非空

客户正在使用传输通道

由于硬件故障或其他情况，无法确定传输通道上是否有钞币

设备报告无法确认传输通道上是否有钞币

fwTransport

提供传输通道状态。参数将会是下列值之一：

涵义

通道状态正常

传输通道不活动，由于硬件故障或者传输媒介异常 由于硬件故障或其他情况，传输通道状态不能够被确定 物理设备没有传输通道或其状态报告不被支持 涵义

输出位为空。 输出位非空。

由于硬件故障或其他情况，输出位状态不能够被确定 设备报告无法确认输出位置。