WOSA／XFS 3.10 中文版 04

第13页

CWA 15748-4:2008

WFS_IDC_CHIPMODNOTSUPP fwMagReadModule

指定读磁模块的状态是以下值之一。 值

WFS_IDC_MAGMODOK WFS_IDC_MAGMODINOP

WFS_IDC_MAGMODUNKNOWN WFS_IDC_MAGMODNOTSUPP fwMagWriteModule

指定写磁模块的状态是以下值之一。 值

WFS_IDC_MAGMODOK WFS_IDC_MAGMODINOP

WFS_IDC_MAGMODUNKNOWN WFS_IDC_MAGMODNOTSUPP

报告芯片模块的状态不支持。

意义

读磁模块处于良好的状态。 读磁模块不可用。

读磁模块的状态不能确定。 报告磁.模块的状态不支持。

意义

写磁模块处于良好的状态。 写磁模块不可用。

写磁模块的状态不能确定。 报告写磁.模块的状态不支持。

fwFrontImageModule

指定读卡器正面图像读取模块的状态，是以下值之一：

值 意义 WFS_IDC_IMGMODOK 正面图像读取模块处于良好的状态。. WFS_IDC_IMGMODINOP 正面图像读取模块不可用。 WFS_IDC_IMGMODUNKNOWN 正面图像读取模块的状态不能确定。 WFS_IDC_IMGMODNOTSUPP 报告正面图像读取模块的状态不支持。 fwBackImageModule

指定读卡器背面图像读取模块的状态，是以下值之一：

值

WFS_IDC_IMGMODOK WFS_IDC_IMGMODINOP

WFS_IDC_IMGMODUNKNOWN WFS_IDC_IMGMODNOTSUPP

意义

背面图像读取模块处于良好的状态。. 背面图像读取模块不可用。

背面图像读取模块的状态不能确定。 报告背面图像读取模块的状态不支持。

wDevicePosition

指定读卡器的位置。读卡器的位置不是依赖于fwDevice 值，例如当读卡器位置被报告为WFS_IDC_DEVICENOTINPOSITION时，fwDevice 值可以是以上定义的任一值（包括WFS_IDC_DEVONLINE或 WFS_IDC_DEVOFFLINE）。如果该读卡器没有处于正常的操作位置的话（也就是WFS_IDC_DEVICEINPOSITION），那么卡就不会通过正常的客户接口呈现。 是以下值之一。

第14页 CWA 15748-4:2008

错误代码 注释

值

意义

WFS_IDC_DEVICEINPOSITION 读卡器处于正常操作位置，或者被固定在某一位置或者不能被移动。 WFS_IDC_DEVICENOTINPOSITION 读卡器被从它的正常操作位置移走。

WFS_IDC_DEVICEPOSUNKNOWN

由于硬件错误或者其它的情况，读卡器的位置不能确定。

WFS_IDC_DEVICEPOSNOTSUPP

实际设置没有能力检测其位置。

usPowerSaveRecoveryTime

指定读卡器从目前节电状态恢复到正常状态所需要的实际秒数。如果节电模式未被激活或者是不支持节电控制，那么该值为零。

只有[Ref. 1]中定义的一般的错误代码才能由该命令产生。

要求或者期待特殊信息出现在lpszExtra 参数上的应用程序可能不是读卡器或者不依赖

厂商。

如果fwDevice字段表明读卡器依旧是可用的(也就是WFS_IDC_DEVONLINE)，即使详细读卡器状态中的一个字段（(fwSecurity, fwChipModule, fwMagReadModule 或 fwMagWriteModule)表明一个或多个模块除了问题。在这种情况下，只能使用确实无问题的模块的函数。 在与读卡器失去联络的情况下，fwDevice 信息组会报告出WFS_IDC_DEVPOWEROFF（在读卡器未被移除的情况下）或者是WFS_IDC_DEVHWERROR（如果意外失去联络）。所有其它的信息组应该包括一个基于以下原则或优先权的值。 1. 报告该值为未知值

2. 报告该值为普通的h/w错误 3. 报告该值为最后为人所知的值

第15页

CWA 15748-4:2008

4.2 WFS_INF_IDC_CAPABILITIES

描述 输入参数

该命令是用来获取读卡器的性能。 无

输出参数 LPWFSIDCCAPS lpCaps;

typedef struct _wfs_idc_caps

{ WORD wClass; WORD fwType; BOOL bCompound; WORD fwReadTracks; WORD fwWriteTracks; WORD fwChipProtocols; USHORT usCards; WORD fwSecType; WORD fwPowerOnOption; WORD fwPowerOffOption; BOOL bFluxSensorProgrammable; BOOL bReadWriteAccessFollowingEject; WORD fwWriteMode; WORD fwChipPower; LPSTR lpszExtra; WORD fwDIPMode; LPWORD lpwMemoryChipProtocols; DWORD dwGuidLights[WFS_IDC_GUIDLIGHTS_SIZE]; WORD fwEjectPosition; BOOL bPowerSaveControl; } WFSIDCCAPS, *LPWFSIDCCAPS;

wClass

指定逻辑服务类是WFS_SERVICE_CLASS_IDC。 fwType

指定读卡器的类型，可以是以下值： 值 WFS_IDC_TYPEMOTOR WFS_IDC_TYPESWIPE WFS_IDC_TYPEDIP

WFS_IDC_TYPECONTACTLESS WFS_IDC_TYPELATCHEDDIP

意义 读卡器是一个电动式读卡器。读卡器是一个插卡式读卡器。

读卡器是一个刷卡式读卡器。刷卡式读卡器不可能锁住插入的卡。

读卡器是一个非接触读卡器，也就是说不需要插入卡。

读卡器是一个锁定直列式读卡器。当支持IC芯片通信的时候，可锁定卡，以保证在IC芯片通信时，客户不能将卡移走。当请求激活一个芯片时（通过

WFS_CMD_IDC_READ_RAW_DATA命令），任何插入的卡都会被自动锁定。 .

读卡器使用一种永久的荷载的芯片卡（使用这种类型的卡，可以不需要用户的交互作用）。

WFS_IDC_TYPEPERMANENT

bCompound

指定读卡器是不是复合读卡器的一部分。

fwReadTracks

指定读卡器可以读取的磁道，可以是如下标志的一个或多个：

第16页 CWA 15748-4:2008

值

WFS_IDC_NOTSUPP WFS_IDC_TRACK1 WFS_IDC_TRACK2 WFS_IDC_TRACK3 WFS_IDC_TRACK_WM

WFS_IDC_FRONT_TRACK_1 WFS_IDC_FRONTIMAGE

WFS_IDC_BACKIMAGE

意义

读卡器不支持读磁道。 读卡器可以读磁道1. 读卡器可以读磁道2. 读卡器可以读磁道3. 读卡器可以读瑞典的水印数据。 读卡器可以读前磁道1.

在某些国家该磁道被称为JIS II track. 读卡器可以读取卡的正面图像。

读卡器可以读取卡的背面图像。

fwWriteTracks

指定读卡器可以写入的磁道（可以是fwReadTracks 中描述的除了WFS_IDC_TRACK_WM 之外的标志中的一个或多个。）

fwChipProtocols

指定读卡器支持的IC芯片协议，可以是如下标志的一个或多个：

Value 意义 WFS_IDC_NOTSUPP 读卡器不支持IC芯片协议 WFS_IDC_CHIPT0 读卡器支持T=0协议 WFS_IDC_CHIPT1 读卡器支持T=1协议

WFS_IDC_CHIP_PROTOCOL_NOT_REQUIRED 读卡器不需要应用程序来设置协议

而可以与芯片卡通信 usCards

指定回收盒可以容纳的最大卡张数(如果不可用则为0)。 fwSecType

指定安全单元的类型，可以是以下值之一: Value

WFS_IDC_SECNOTSUPP WFS_IDC_SECMMBOX WFS_IDC_SECCIM86

意义

读卡器没有安全单元。 读卡器的安全单元是MMBox。读卡器的安全单元是CIM86。

fwPowerOnOption

指定读卡器开电时对卡的操作，可以是以下值之一（只适用于电动式读卡器）： Value

WFS_IDC_NOACTION WFS_IDC_EJECT

WFS_IDC_RETAIN

WFS_IDC_EJECTTHENRETAIN

意义

开电时不对卡操作，保持原来的位置。 开电(断电) 时卡被退到入卡口（或断电时对卡的操作，请参见下边的fwPowerOffOption ） 开电(断电) 时卡被回收. 开电(断电) 时卡被退到入卡口，在厂商规定的时间内卡没有被取走，卡将被回收。 开电(断电) 时卡被移至读卡位置。

WFS_IDC_READPOSITION

fwPowerOffOption

指定读卡器断电时对卡的操作，同fwPowerOnOption标志，这只适用于电动式读卡器。