ItemDispenser Class

2/27/2008

Defines the programmatic interface for an Item Dispenser device.

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

Syntax

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

Remarks

Required Version

The ItemDispenser class requires POS for .NET version 1.12 or later versions.

Capabilities

The Item Dispenser has the following capability:

  • Supports a method that allows a specified number of items to be dispensed from the device.

The Item Dispenser may have the following additional capabilities:

  • Status reporting which indicates empty item slot conditions, almost empty item slot conditions and item slot jamming conditions.

  • Supports multiple items dispensed from different slots.

  • Status reporting in individual item type.

Programming Model

An Item Dispenser consists of slots holding items (for example, CDs, prepaid telephone card, and more) to be dispensed. An application that uses the Item Dispenser service is not concerned with controlling the individual slots of items to be dispensed, but calls a method with the number of items to be dispensed. It is the responsibility of the Item Dispenser device or the service to dispense the correct number of items from the various slots.

Device Sharing

The Item Dispenser is an exclusive-use device. The 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 or collecting, or receiving events.

Inheritance Hierarchy

System.Object
   Microsoft.PointOfService.PosDevice
     Microsoft.PointOfService.PosCommon
      Microsoft.PointOfService.ItemDispenser
         Microsoft.PointOfService.BasicServiceObjects.ItemDispenserBasic

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

ItemDispenser Members
Microsoft.PointOfService Namespace