Udostępnij przez

Dodawanie obsługi Plug and Play (dokumentacja POS dla zestawu SDK .NET w wersji 1.14)

Usługa Microsoft Point of Service dla platformy .NET (POS dla platformy .NET) obejmuje obsługę urządzeń Plug and Play. Dzięki dodaniu obsługi technologii Plug and Play do obiektów usługi aplikacje mogą stać się prostsze, niezawodne i wydajne. Obiekty usługi powinny obsługiwać je zawsze, gdy jest to możliwe.

Implementowanie obsługi technologii Plug and Play na poziomie obiektu usługi jest bardzo proste. Gdy znasz identyfikator sprzętu urządzenia, po prostu dodaj pojedynczy atrybut do klasy HardwareIdAttribute. Atrybut HardwareId jest używany przez PosExplorer program do inteligentnego filtrowania obiektów usługi z listy dostępnych urządzeń w zależności od stanu urządzenia. Jeśli obiekt usługi ma HardwareId atrybut odwołujący się do zainstalowanego urządzenia Plug and Play, ale to urządzenie nie jest połączone, obiekt usługi zostanie wykluczony z listy urządzeń PosExplorer . Ta lista jest zwracana, gdy aplikacje wywołają metodę GetDevices().

Obiekty usługi mogą również mieć więcej niż jeden HardwareId atrybut, w tym przypadku PosExplorer kojarzy związek wszystkich określonych urządzeń z obiektem usługi. Istnieje możliwość zastąpienia HardwareId atrybutów lub dodania do listy skojarzonego sprzętu w obiekcie usługi bez ponownego kompilowania zestawu obiektu usługi. Aby uzyskać informacje na temat zastępowania lub dodawania atrybutu HardwareId , zobacz Plug and Play XML Configuration (Konfiguracja XML plug and Play).

Tylko aplikacja jest odpowiedzialna za przechwytywanie zdarzeń DeviceAddedEvent i DeviceRemovedEvent oraz aktualizowanie jego stanu zgodnie z potrzebami, na podstawie zaktualizowanej listy urządzeń zwróconej z PosExplorer. Obiekt usługi nie musi wykrywać tych zdarzeń.

Aby dodać atrybut HardwareId do klasy Obiektu usługi

  1. Określ zakres identyfikatorów sprzętu dla urządzenia lub urządzeń, które obsługuje obiekt usługi.

  2. Dodaj atrybut HardwareId przed definicją swojej klasy, używając najniższego i najwyższego identyfikatora sprzętu wykorzystywanego przez Twoje urządzenie. Wiele HardwareId atrybutów może służyć do identyfikowania wielu zakresów identyfikatorów sprzętu.

Example

Poniższy przykład dodaje atrybut HardwareId do szablonu podstawowego pokazanego w poprzedniej sekcji.

using System;

using Microsoft.PointOfService;
using Microsoft.PointOfService.BaseServiceObjects;

namespace SOTemplate
{

    [HardwareId("HID\\Vid_05e0&Pid_038a",
                "HID\\Vid_05e0&Pid_038a")]

    [ServiceObject(
                DeviceType.Msr,
                "ServiceObjectTemplate",
                "Bare bones Service Object class",
                1,
                9)]
    public class MyServiceObject : MsrBase
    {
        public MyServiceObject()
        {
        }
    }
}

Zobacz też

Tasks

Koncepcje

Inne zasoby

  • Last updated on