Description This command is used to retrieve the capabilities of the ID card unit.
Input Param None.
Output Param 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;
LPSTR lpszExtra;
} WFSIDCCAPS, * LPWFSIDCCAPS;
wClass
Specifies the logical service class; value is WFS_SERVICE_CLASS_IDC
fwType
Specifies the type of the ID card unit as one of the following flags:
Value Meaning
WFS_IDC_TYPEMOTOR The ID card unit is a motor driven card unit.
WFS_IDC_TYPESWIPE The ID card unit is a swipe (pull-through) card unit .
WFS_IDC_TYPEDIP The ID card unit is a dip card unit.
WFS_IDC_TYPECONTACTLESS The ID card unit is a contactless card unit, i.e. no insertion of the card is required.
bCompound
Specifies whether the logical device is part of a compound physical device and is either TRUE or FALSE.
fwReadTracks
Specifies the tracks that can be read by the ID card unit as a combination of the following flags:
Value Meaning
WFS_IDC_NOTSUPP The ID card unit can not access any track.
WFS_IDC_TRACK1 The ID card unit can access track 1.
WFS_IDC_TRACK2 The ID card unit can access track 2.
WFS_IDC_TRACK3 The ID card unit can access track 3.
fwWriteTracks
Specifies the tracks that can be written by the ID card unit (as a combination of the flags specified in the description of fwReadTracks).
fwChipProtocols
Specifies the chip card protocols that are supported by the service provider as a combination of the following flags:
Value Meaning
WFS_IDC_NOTSUPP The ID card unit can not handle chip cards.
WFS_IDC_CHIPT0 The ID card unit can handle the T=0 protocol.
WFS_IDC_CHIPT1 The ID card unit can handle the T=1 protocol.
WFS_IDC_CHIPT2 The ID card unit can handle the T=2 protocol.
WFS_IDC_CHIPT3 The ID card unit can handle the T=3 protocol.
WFS_IDC_CHIPT4 The ID card unit can handle the T=4 protocol.
WFS_IDC_CHIPT5 The ID card unit can handle the T=5 protocol.
WFS_IDC_CHIPT6 The ID card unit can handle the T=6 protocol.
WFS_IDC_CHIPT7 The ID card unit can handle the T=7 protocol.
WFS_IDC_CHIPT8 The ID card unit can handle the T=8 protocol.
WFS_IDC_CHIPT9 The ID card unit can handle the T=9 protocol.
WFS_IDC_CHIPT10 The ID card unit can handle the T=10 protocol.
WFS_IDC_CHIPT11 The ID card unit can handle the T=11 protocol.
WFS_IDC_CHIPT12 The ID card unit can handle the T=12 protocol.
WFS_IDC_CHIPT13 The ID card unit can handle the T=13 protocol.
WFS_IDC_CHIPT14 The ID card unit can handle the T=14 protocol.
WFS_IDC_CHIPT15 The ID card unit can handle the T=15 protocol.
usCards
Specifies the maximum numbers of cards that the retain bin can hold (zero if not available).
fwSecType
Specifies the type of security module used as one of the following flags:
Value Meaning
WFS_IDC_SECNOTSUPP Device has no security module.
WFS_IDC_SECMMBOX Security module of device is MMBox.
WFS_IDC_SECCIM86 Security module of device is CIM86.
fwPowerOnOption
Specifies the power-on capabilities of the device hardware, as one of the following flags; applicable only to motor driven ID card units.
Value Meaning
WFS_IDC_NOACTION No power on actions are supported by the device
WFS_IDC_EJECT The card will be ejected on power-on (or off, see fwPowerOffOption below).
WFS_IDC_RETAIN The card will be retained on power-on (off).
WFS_IDC_EJECTTHENRETAIN The card will be ejected for a specified time on power-on (off), then retained if not taken. The time for which the card is ejected is vendor dependent.
WFS_IDC_READPOSITION The card will be moved into the read position on power-on (off).
fwPowerOffOption
Specifies the power-off capabilities of the device hardware, as one of the flags specified for fwPowerOnOption; applicable only to motor driven ID card units.
lpszExtra
Points to a list of vendor-specific, or any other extended information. The information is returned as a series of "key=value" strings so that it is easily extensible by service providers. Each string is null-terminated, with the final string terminating with two null characters.
Error Codes There are no additional error codes generated by this command.
Comments Applications which require or expect specific information to be present in the lpszExtra parameter may not be device or vendor-independent.