Udostępnij za pośrednictwem

Plug and Play XML Configuration (POS for .NET v1.14 SDK Documentation)

Mimo że identyfikator sprzętu Plug and Play powinien być ogólnie określony przy użyciu HardwareId właściwości w kodzie źródłowym obiektu usługi, mogą wystąpić czasy, gdy dostawcy obiektów usługi wymagają większej elastyczności. Na przykład identyfikator sprzętu należy zmienić bez ponownego dystrybuowania całego zestawu obiektów usługi.

Aby obsłużyć te przypadki, punkt usługi microsoft dla platformy .NET (POS for .NET) określa skojarzenia sprzętu w pliku XML. Te pliki XML są odczytywane z katalogu określonego w kluczu rejestru HKEY_LOCAL_MACHINE/SOFTWARE/POSfor.NET/ControlConfigs. Podczas tworzenia listy dostępnych obiektów i urządzeń usługi przetwarza każdy plik w tym katalogu i kojarzy urządzenie tam, PosExplorer gdzie to możliwe. Obiekt usługi lub aplikacja nie wymaga żadnej dodatkowej akcji.

Schemat

Plik konfiguracji Plug and Play musi rozpoczynać się od węzła najwyższego poziomu o nazwie PointOfServiceConfig i mieć atrybut Version (Wersja atrybutu), aby wskazać wersję XML pliku.

Następnie może istnieć dowolna liczba podwęźle ServiceObject . Każdy węzeł obiektu usługi musi zawierać atrybuty Typ i Nazwa , aby wskazać typ i nazwę urządzenia POS obiektu usługi. Te dwa pola zostaną dopasowane do dostępnych obiektów usługi, aby określić, które, jeśli istnieją, powinny być skojarzone z urządzeniami określonymi w podwęźle HardwareId. W węźle ServiceObject istnieje również opcjonalny atrybut Zastąpić. Jeśli ten atrybut jest ustawiony, skojarzenia urządzenia w pliku XML zastępują te zawarte w zestawie.

Węzeł ServiceObject zawiera podwęźniki o nazwie HardwareId, które mają atrybuty From i To . Zawartość tych atrybutów jest taka sama jak w atrybucie HardwareId w zestawie obiektu usługi i określ zakres identyfikatorów sprzętu do skojarzenia z obiektem usługi.

Przykład

W przykładzie przedstawiono typowy plik konfiguracji 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>

Pierwszeństwo identyfikatora sprzętu

Jeśli atrybut Przesłonięcia w węźle ServiceObject jest ustawiony, skojarzenie urządzenia określone w kodzie XML ma pierwszeństwo, a dowolny atrybut HardwareId w obiekcie usługi zostanie odrzucony.

Jeśli atrybut Przesłonięcia nie jest ustawiony, nie ma pierwszeństwa ani XML, ani HardwareId. Zamiast tego posExplorer kojarzy związek wszystkich określonych urządzeń z obiektem usługi.

Zobacz też

Zadania

Pojęcia