Share via

RFIDScanner.StartReadTags Method

  • Article

2/27/2008

Performs a continuous polling of tags that meet the parameterized criteria.

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

Syntax

'Declaration
Public MustOverride Sub StartReadTags ( _
    cmd As RFIDReadOptions, _
    filterId As Byte(), _
    filterMask As Byte(), _
    start As Integer, _
    length As Integer, _
    password As Byte() _
)

public abstract void StartReadTags (
    RFIDReadOptions cmd,
    byte[] filterId,
    byte[] filterMask,
    int start,
    int length,
    byte[] password
)

public:
virtual void StartReadTags (
    RFIDReadOptions cmd, 
    array<unsigned char>^ filterId, 
    array<unsigned char>^ filterMask, 
    int start, 
    int length, 
    array<unsigned char>^ password
) abstract

public abstract void StartReadTags (
    RFIDReadOptions cmd, 
    byte[] filterId, 
    byte[] filterMask, 
    int start, 
    int length, 
    byte[] password
)

public abstract function StartReadTags (
    cmd : RFIDReadOptions, 
    filterId : byte[], 
    filterMask : byte[], 
    start : int, 
    length : int, 
    password : byte[]
)

Parameters

  • cmd
  • filterId
    Holds a bit pattern to be AND-ed with filterMask to determine which tag(s) to read.
  • filterMask
    Holds a value which is used to mask the filterID. If the bitwise AND matches the bitwise AND of a tagId and the filterMask, the tagId will be returned. To get all tags in the field, pass in a filterMask of 0.
  • start
    Indicates the zero-based position within the tags UserData field to begin reading from. This parameter only applies when cmd is set to PartialUserData or PartialUserData. Otherwise, it is ignored.
  • length
    Indicates the number of bytes of user data to read starting at the position indicated by the start parameter. This parameter only applies when cmd is set to PartialUserData or PartialUserData. Otherwise, it is ignored.
  • password
    Authorized key for reader that might be required for this operation; null if not applicable.

Remarks

Each polling operation results in either a DataEvent or an ErrorEvent event being sent. The service continues polling until the StopReadTags method is invoked.

If the ContinuousReadMode property value is true during the StartReadTags method execution, invoking another StartReadTags method throws an exception.

This method is always performed asynchronously, but the OutputId property is not set and OutputCompleteEvents events are not sent because of calling this method.

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

RFIDScanner Class
RFIDScanner Members
Microsoft.PointOfService Namespace