Compartilhar via

Configuração XML do Plug and Play (POS para documentação do SDK do .NET v1.14)

Embora a ID de hardware Plug and Play geralmente deva ser especificada usando a propriedade HardwareId no código-fonte do Objeto de Serviço, pode haver momentos em que fornecedores de Objeto de Serviço exigem mais flexibilidade. Por exemplo, a ID de hardware precisa ser alterada sem redistribuir todo o assembly do Objeto de Serviço.

Para dar suporte a esses casos, o Ponto de Serviço do Microsoft para .NET (POS para .NET) especifica associações de hardware em um arquivo XML. Esses arquivos XML são lidos do diretório especificado na chave do Registro HKEY_LOCAL_MACHINE/SOFTWARE/POSfor.NET/ControlConfigs. Ao construir a lista de objetos e dispositivos de serviço disponíveis, PosExplorer processa cada arquivo nesse diretório e associa o dispositivo sempre que possível. Nenhuma ação adicional é necessária pelo Objeto de Serviço ou pelo aplicativo.

Schema

Um arquivo de configuração Plug and Play deve começar com um nó de nível superior chamado PointOfServiceConfig e ter o atributo Version para indicar a versão XML do arquivo.

Depois disso, pode haver qualquer número de subnodos ServiceObject . Cada nó de objeto de serviço deve incluir Type e Name atributos para indicar o tipo de dispositivo POS e o nome do Objeto de Serviço. Esses dois campos serão correspondidos com objetos de serviço disponíveis para determinar quais, se houver, devem ser associados a dispositivos especificados no hardwareId do subnodo. Também há um atributo opcional Override no nó ServiceObject. Se esse atributo for definido, as associações de dispositivo no arquivo XML substituirão as contidas no assembly.

O nó ServiceObject contém subnodos com o nome HardwareId, que têm From e To atributos. O conteúdo desses atributos é o mesmo que seria encontrado no HardwareId atributo em um assembly do Objeto de Serviço e especifica o intervalo de IDs de hardware a serem associadas ao Objeto de Serviço.

Example

O exemplo mostra um arquivo de configuração típico de Plug and Play XML.

<PointOfServiceConfig Version="1.0">
    <ServiceObject Type="Msr" Name="ExampleMsr" Override="yes">
        <HardwareId From="HID\Vid_0801&Pid_0002&Rev_0100"
                    To="HID\Vid_0801&Pid_0002&Rev_9999" />
    </ServiceObject>
</PointOfServiceConfig>

Precedência do ID de hardware

Se o Override atributo no nó ServiceObject estiver definido, a associação de dispositivo especificada no XML terá precedência e qualquer HardwareId atributo no Objeto de Serviço será descartado.

Se o Override atributo não estiver definido, nem o XML nem o HardwareId têm precedência. Em vez disso, PosExplorer associa a união de todos os dispositivos especificados ao Objeto de Serviço.

Consulte Também

Tasks

Conceitos

  • Last updated on