CoinDispenser Class

2/27/2008

Defines the programmatic interface for a UPOS Coin Dispenserdevice.

Namespace: Microsoft.PointOfService
Assembly: Microsoft.PointOfService (in microsoft.pointofservice.dll)

Syntax

'Declaration
Public MustInherit Class CoinDispenser
    Inherits PosCommon
public abstract class CoinDispenser : PosCommon
public ref class CoinDispenser abstract : public PosCommon
public abstract class CoinDispenser extends PosCommon
public abstract class CoinDispenser extends PosCommon

Remarks

Capabilities

Coin Dispenser devices support a method to dispense a specified amount of coins. A Coin Dispenser device may also support status reporting to indicate an empty or near-empty coin slot, discrepancies in reported data, or a jammed coin slot condition.

Model

A coin dispenser has several coin slots that hold coins to dispense. When you write code for a coin dispenser, you are not concerned with controlling individual coin slots; instead, you call the DispenseChange method with the change to dispense. It is the responsibility of the coin dispenser or the service object to dispense the correct amount of change from the various slots.

Cash is set in the device programmatically by adding amount to counts when cash is added. The coin dispenser then reads cash counts from device, either directly from the hardware or from the service, by tracking what has been dispensed and what has been added to the device.

Device Sharing

The coin dispenser is an exclusive-use device. Its device-sharing rules are as follows:

  • The application must claim the device before the application enables it.

  • The application must claim and enable the device before accessing some properties, dispensing change, or receiving status update events.

Inheritance Hierarchy

System.Object
   Microsoft.PointOfService.PosDevice
     Microsoft.PointOfService.PosCommon
      Microsoft.PointOfService.CoinDispenser
         Microsoft.PointOfService.BasicServiceObjects.CoinDispenserBasic

Thread Safety

Any public static (Shared in Visual Basic) members of this type are thread-safe. Any instance members are not guaranteed to be thread-safe.

See Also

Reference

CoinDispenser Members
Microsoft.PointOfService Namespace