Partilhar via

Adição de Suporte Plug and Play (Documentação do SDK do POS para .NET v1.14)

O Microsoft Point of Service para .NET (POS para .NET) inclui suporte para dispositivos Plug and Play. Ao adicionar suporte Plug and Play aos seus Objetos de Serviço, as aplicações podem tornar-se mais simples, fiáveis e eficientes. Os Objetos de Serviço devem suportá-lo sempre que possível.

Implementar suporte Plug and Play ao nível do Objeto de Serviço é muito simples. Quando souber o ID do hardware do seu dispositivo, basta adicionar um único atributo à sua classe, HardwareIdAttribute. O HardwareId atributo é usado por PosExplorer para filtrar inteligentemente os Objetos de Serviço da lista de dispositivos disponíveis, dependendo do estado do dispositivo. Se o Objeto de Serviço tiver um HardwareId atributo que se refere a um dispositivo Plug and Play instalado, mas esse dispositivo não estiver ligado, o Objeto de Serviço será excluído da lista de dispositivos do PosExplorer . Esta lista é devolvida quando as aplicações chamam GetDevices().

Os Objetos de Serviço também podem ter mais do que um HardwareId atributo, caso em que o PosExplorer associa uma união de todos os dispositivos especificados ao Objeto de Serviço. É possível sobrescrever os HardwareId atributos ou adicionar à lista de hardware associado no Objeto de Serviço sem reconstruir o conjunto do Objeto de Serviço. Para informações sobre sobreposição ou adição do HardwareId atributo, consulte Configuração XML Plug and Play.

Só a aplicação é responsável por capturar eventos DeviceAddedEvent e DeviceRemovedEvent e atualizar o seu estado conforme apropriado, com base na lista atualizada de dispositivos fornecida pelo PosExplorer. O Objeto de Serviço não precisa de detetar estes eventos.

Para adicionar um atributo HardwareId à sua classe de Objeto de Serviço

  1. Determine o intervalo de IDs de hardware para o dispositivo ou dispositivos que o seu Objeto de Serviço suporta.

  2. Adiciona um HardwareId atributo antes da definição da tua classe usando o ID de hardware mais baixo usado pelo teu dispositivo e o mais alto. Múltiplos HardwareId atributos podem ser usados para identificar múltiplos intervalos de IDs de hardware.

Example

O exemplo seguinte adiciona um HardwareId atributo ao modelo básico mostrado na secção anterior.

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()
        {
        }
    }
}

Ver também

Tasks

Conceitos

Outros recursos

  • Last updated on