Sdílet prostřednictvím

Podpora Plug and Play (Dokumentace k sadě POS pro .NET v1.14 SDK)

POS pro .NET plně podporuje technologii Windows Embedded Plug and Play. Aby mohli tuto funkci využít, můžou vývojáři service object jednoduše přidat jeden nebo více HardwareId atributů do kódu nebo zahrnout odkaz na hardware do konfiguračního souboru Plug and Play XML .

Přidání tohoto atributu do objektu služby pomáhá vývojářům aplikací, kteří teď budou vědět, že když se použije PosExplorer k získání seznamu objektů služby, všechny objekty služby v tomto seznamu budou přidružené k funkčnímu zařízení POS. Aplikace využívá přímo z tohoto přidružení větší spolehlivost a snadné použití. Pokud je to možné, doporučujeme, aby objekty služby podporovaly funkci Plug and Play.

Chování modulu Plug and Play

Jakmile je objekt služby přidružený k ID hardwaru zařízení POS, použije POS pro .NET správce technologie Windows Plug and Play k určení zařízení poS připojených k počítači. Aplikace nebo objekt služby nevyžaduje žádný další kód.

Když aplikace vyvolá metodu PosExplorer.GetDevices, PosExplorer najde zařízení, které je přidruženo k jednotlivým objektům plug-and play služby, a potom se dotazuje Správce plug-and play systému Windows, aby určil stav zařízení. Pokud zařízení není k dispozici, nepřidá se do seznamu zařízení, který se vrátí do aplikace z PosExplorer.GetDevices.

Filtrování objektů služby PosExplorer

PosExplorer je schopen efektivně filtrovat seznam objektů služby Plug and Play, když aplikace volá PosExplorer.GetDevices. Proces filtrování funguje takto:

  1. Vyhledá všechna sestavení ve specifikovaných adresářích POS pro .NET.
  2. Pokud sestavení není označené globálním atributem PosAssembly , zahodí ho.
  3. Vyhledá třídy označené atributem ServiceObject . Pro každou z těchto tříd:
    1. Vyhledá ID hardwaru přidružené k této třídě jako HardwareId atribut nebo v rámci konfiguračního souboru Plug and Play XML . Pokud neexistuje žádné ID hardwaru, ponechte objekt služby v seznamu PosExplorer .
    2. Pokud je k dispozici hardwarový ID, dotazuje systém Windows, aby načetl stav zařízení. Pokud je zařízení připojené k počítači, ponechá ho v seznamu PosExplorer .
    3. Pokud zařízení není připojené k počítači, odebere ho ze seznamu PosExplorer .

Example

Následující příklad kódu ukazuje jednoduchou metodu zpracování událostí Plug and Play. Informace vygenerované nástrojem PosExplorer slouží k vytvoření instance správného zařízení, v tomto případě magnetického stripe readeru (MSR).

// Connect the Plug and Play events to detect the removal or
// connection of a new device.
   explorer.DeviceAddedEvent += new
         DeviceChangedEventHandler(explorer_DeviceAddedEvent);
   explorer.DeviceRemovedEvent += new
         DeviceChangedEventHandler(explorer_DeviceRemovedEvent);

// This event handler extends Plug and Play functionality to the MSR
// device type. A message is printed to the console if the connection
// is successful.
void explorer_DeviceAddedEvent(object sender, DeviceChangedEventArgs e)
{

   // Checks if the newly added device is an MSR.
   if (e.Device.Type == DeviceType.Msr)
   {

      // Checks if an MSR instance has already been created and,
      // if not,creates one. If a new MSR instance is created, its
      // name is recorded in a string and written to the console.
      // Once the printing is finished, the MSR is closed.
      if (msr == null)
      {
         CreateMsr(e.Device);
         strMsrConfig = e.Device.ServiceObjectName;
         Console.WriteLine(strMsrConfig);
         // It is important that applications close all open
         // Service Objects before terminating.
         msr.Close();
      }
   }
}

Viz také

Tasks

Odkazy

Koncepce

Další zdroje informací

  • Last updated on