Adición de compatibilidad con Plug and Play (POS para la documentación del SDK de .NET v1.14)

Microsoft Point of Service para .NET (POS para .NET) incluye compatibilidad con dispositivos Plug and Play. Al agregar compatibilidad con Plug and Play a los objetos de servicio, las aplicaciones pueden ser más sencillas, confiables y eficientes. Los objetos de servicio deben admitirlo siempre que sea posible.

La implementación de la compatibilidad con Plug and Play en el nivel de objeto de servicio es muy sencilla. Una vez que conozca el identificador de hardware del dispositivo, basta con agregar un único atributo a la clase , HardwareIdAttribute. El HardwareId atributo se usa para PosExplorer filtrar de forma inteligente objetos de servicio de la lista de dispositivos disponibles en función del estado del dispositivo. Si el objeto de servicio tiene un HardwareId atributo que hace referencia a un dispositivo Plug and Play instalado, pero ese dispositivo no está conectado, el objeto de servicio se excluirá de la lista de dispositivos PosExplorer . Esta lista se devuelve cuando las aplicaciones llaman a GetDevices().

Los objetos de servicio también pueden tener más de un HardwareId atributo, en cuyo caso PosExplorer asocia una unión de todos los dispositivos especificados con el objeto de servicio. Es posible invalidar los HardwareId atributos o agregar a la lista de hardware asociado en el objeto de servicio sin volver a generar el ensamblado de objeto de servicio. Para obtener información sobre cómo invalidar o agregar el HardwareId atributo, vea Configuración XML de Plug and Play.

Solo la aplicación es responsable de detectar los DeviceAddedEvent y DeviceRemovedEvent eventos, y de actualizar su estado según corresponda en función de la lista de dispositivos actualizada devuelta por PosExplorer. El objeto de servicio no necesita detectar estos eventos.

Para agregar un atributo HardwareId a la clase Service Object

1. Determine el intervalo de identificadores de hardware para el dispositivo o los dispositivos que admite el objeto de servicio.

2. Agregue un HardwareId atributo antes de la definición de clase con el identificador de hardware más bajo usado por el dispositivo y el más alto. Se pueden usar varios HardwareId atributos para identificar varios intervalos de identificadores de hardware.

Example

En el ejemplo siguiente se agrega un HardwareId atributo a la plantilla básica que se muestra en la sección 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()
        {
        }
    }
}

Véase también

Tasks

• Creación de una plantilla de código de objeto de servicio básico
• Creación de un ejemplo de objeto de servicio

Conceptos

• Atributos para identificar objetos de servicio y asignar hardware
• Configuración XML de Plug and Play

Otros recursos

• Ejemplos de objetos de servicio: Introducción
• POS para la arquitectura de objetos de servicio de .NET