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
提供传输通道状态。参数将会是下列值之一：
涵义
通道状态正常
传输通道不活动，由于硬件故障或者传输媒介异常 由于硬件故障或其他情况，传输通道状态不能够被确定 物理设备没有传输通道或其状态报告不被支持 涵义
输出位为空。 输出位非空。
由于硬件故障或其他情况，输出位状态不能够被确定 设备报告无法确认输出位置。