beautypg.com

Return value, Remarks – MagTek MAGTEK User Manual

Page 70

background image

MagTek Communications Protocol, Driver Reference Manual

64

Return Value


The returned value indicates the outcome of the enumeration function.

Value

Meaning

MCP_ST_OK

Success. The property value has been set

MCP_ST_NOT_FOUND

The property could not be found

MCP_ST_INVALID

Invalid device handle hDevice

MCP_ST_REFUSE

The data type does not match the expected data type.

MCP_ST_OVERFLOW

The property value is too large

MCP_ST_OUT_OF_RAN
GE

The property value is not within the range of the allowed values

MCP_ST_BAD_ACCESS

There has been an attempt to set a "Read Only" property

MCP_ST_FAILED Other

error.


Remarks


The dwOperAttribute member is used to indicate whether the property is being accessed from the
MCP driver (MCP_ATTR_PROP_DRIVER) or MCP device applications
(MCP_ATTR_NONE).

The MCP device applications identify properties only by numeric IDs due to the limited amount
of memory and processing power.

lpszPropertyName

must be set to null when accessing device

application properties. Refer to the device's Command Reference Manual for the available
property IDs and their function.

The MCP driver properties can be specified by name only. See Device instance properties
section for a list of these.