Description This command is used to request device capability information.
Input Param None.
Output Param LPWFSPTRCAPS lpCaps;
typedef struct _wfs_ptr_caps
{
WORD wClass;
WORD fwType;
BOOL bCompound;
WORD wResolution;
WORD fwReadForm;
WORD fwWriteForm;
WORD fwExtents;
WORD fwControl;
USHORT usMaxRetract;
USHORT usMaxMediaOnStacker;
BOOL bAcceptMedia;
LPSTR lpszExtra;
} WFSPTRCAPS, * LPWFSPTRCAPS;
wClass
Specifies the logical service class, value is:
WFS_SERVICE_CLASS_PTR
fwType
Specifies the type(s) of the physical device driven by the logical service, as a combination of the following flags:
Value Meaning
WFS_PTR_TYPERECEIPT Device is a receipt printer.
WFS_PTR_TYPEPASSBOOK Device is a passbook printer.
WFS_PTR_TYPEJOURNAL Device is a journal printer.
WFS_PTR_TYPEDOCUMENT Device is a document printer.
bCompound
Specifies whether the logical device is part of a compound physical device and is either TRUE or FALSE.
wResolution
Specifies at which resolution(s) the physical device can print. Used by the application to select the level of print quality desired (e.g., as in Word for Windows); does not imply any absolute level of resolution, only relative. Specified as a combination of the following flags:
Value Meaning
WFS_PTR_RESLOW Can print with low resolution.
WFS_PTR_RESMED Can print with medium resolution.
WFS_PTR_RESHIGH Can print with high resolution.
WFS_PTR_RESVERYHIGH Can print with very high resolution.
fwReadForm
Specifies whether the device can read data from media, as a combination of the following flags:
Value Meaning
WFS_PTR_READOCR Device has OCR capability.
WFS_PTR_READMICR Device has MICR capability.
WFS_PTR_READMSF Device has MSF capability.
WFS_PTR_READBARCODE Device has Barcode capability.
WFS_PTR_READPAGEMARK Device has Page Mark capability.
WFS_PTR_READIMAGE Device has imaging capability.
fwWriteForm
Specifies whether the device can write data to the media, as a combination of the following flags:
Value Meaning
WFS_PTR_WRITETEXT Device has Text capability.
WFS_PTR_WRITEGRAPHICS Device has Graphics capability.
WFS_PTR_WRITEOCR Device has OCR capability.
WFS_PTR_WRITEMICR Device has MICR capability.
WFS_PTR_WRITEMSF Device has MSF capability.
WFS_PTR_WRITEBARCODE Device has Barcode capability.
WFS_PTR_WRITESTAMP Device has stamping capability.
fwExtents
Specifies whether the device is able to measure the inserted media, as a combination of the following flags:
Value Meaning
WFS_PTR_EXTHORIZONTAL Device has horizontal size detection capability.
WFS_PTR_EXTVERTICAL Device has vertical size detection capability.
fwControl
Specifies the manner in which media can be controlled, as a combination of the following bit flags:
Value Meaning
WFS_PTR_CTRLEJECT Device can eject media.
WFS_PTR_CTRLPERFORATE Device can perforate media.
WFS_PTR_CTRLCUT Device can cut media.
WFS_PTR_CTRLSKIP Device can skip to mark.
WFS_PTR_CTRLFLUSH Device can be sent data that is buffered internally, and flushed to the printer on request.
WFS_PTR_CTRLRETRACT Device can retract media
WFS_PTR_CTRLSTACK Device can stack media items before ejecting as a bundle.
WFS_PTR_CTRLPARTIALCUT Device can partially cut the media.
WFS_PTR_CTRLALARM Device can ring a bell, beep or otherwise sound an audible alarm.
WFS_PTR_CTRLATPFORWARD Capability to turn one page forward.
WFS_PTR_CTRLATPBACKWARD Capability to turn one page backward.
WFS_PTR_CTRLTURNMEDIA Device can turn inserted media.
usMaxRetract
Specifies the maximum number of media items that the retract bin can hold (zero if not available).
usMaxMediaOnStacker
Specifies the maximum number of media items that the stacker can hold (zero if this capability is not available).
bAcceptMedia
Specifies whether the device is able to accept media while no execute command is running that is waiting explicitly for media to be inserted. Its value is either TRUE or FALSE.
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.