Adicionando suporte a Plug and Play (POS for .NET, documentação do SDK v1.14)

O Ponto de Serviço do Microsoft para .NET (POS para .NET) inclui suporte para dispositivos Plug and Play. Adicionando suporte a Plug and Play aos objetos de serviço, os aplicativos podem se tornar mais simples, confiáveis e eficientes. Os Objetos de Serviço devem dar suporte sempre que possível.

Implementar o suporte a Plug and Play no nível do Objeto de Serviço é muito simples. Depois de conhecer a ID de hardware do dispositivo, basta adicionar um único atributo à sua classe HardwareIdAttribute. O HardwareId atributo é usado para PosExplorer filtrar de forma inteligente 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 conectado, o Objeto de Serviço será excluído da lista de dispositivos PosExplorer . Essa lista é retornada quando os aplicativos chamam GetDevices().

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

Somente o aplicativo é responsável por capturar DeviceAddedEvent e DeviceRemovedEvent eventos e atualizar seu status conforme apropriado com base na lista de dispositivos atualizada retornada do PosExplorer. O Objeto de Serviço não precisa detectar esses 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 aos quais o Objeto de Serviço dá suporte.

2. Adicione um HardwareId atributo antes da definição de classe usando a ID de hardware mais baixa usada pelo dispositivo e a mais alta. Vários HardwareId atributos podem ser usados para identificar vários intervalos de IDs de hardware.

Example

O exemplo a seguir adiciona um HardwareId atributo ao modelo básico mostrado na seçã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()
        {
        }
    }
}

Consulte Também

Tasks

• Criando um modelo de código de objeto de serviço básico
• Criando um exemplo de objeto de serviço

Conceitos

• Atributos para identificar objetos de serviço e atribuir hardware
• Configuração de XML de Plug and Play

Outros recursos

• Exemplos de objeto de serviço: Introdução
• POS para arquitetura de objeto de serviço .NET