Sammlungen auf oberster Ebene
Eine Sammlung auf oberster Ebene ist eine Gruppe von Funktionen, die auf einen bestimmten Softwareanwender (oder einen Verbrauchertyp) der Funktionalität ausgerichtet sind. Beispielsweise kann eine Sammlung auf oberster Ebene als Tastatur, Maus, Verbrauchersteuerung, Sensor, Anzeige usw. beschrieben werden. In der HID-Spezifikation werden diese Auflistungen der obersten Ebene auch als Anwendungssammlungen bezeichnet. Das HID-Gerät beschreibt den Zweck jeder Sammlung auf oberster Ebene, sodass die Verbraucher von HID-Funktionen Sammlungen auf oberster Ebene identifizieren können, an denen sie interessiert sind. In Windows generiert die HID-Gerätesetupklasse (HIDClass) ein eindeutiges physisches Geräteobjekt (PDO) für jede auflistung der obersten Ebene, die vom Berichtsdeskriptor beschrieben wird. Microsoft definiert eine Sammlung auf oberster Ebene als HID-Auflistung , die nicht in einer anderen Auflistung geschachtelt ist. Eine nicht eingestellte Auflistung ist unabhängig vom HID-Typ immer eine Auflistung auf oberster Ebene. Insbesondere muss es sich bei einer Sammlung auf oberster Ebene nicht um eine Anwendungssammlung handeln, wie sie vom USB-HID-Standard definiert ist.
Ein Berichtsdeskriptor kann mehrere Auflistungen auf oberster Ebene enthalten. Der HID-Klassentreiber listet die Auflistungen der obersten Ebene eines Eingabegeräts auf und erstellt ein physisches Geräteobjekt (PDO) für jede Auflistung der obersten Ebene. Benutzermodusanwendungen oder Kernelmodustreiber können auf eine Sammlung auf oberster Ebene zugreifen, indem sie ihre PDO öffnen und die HIDClass-Supportroutinen und die HID-Klassentreiber-IOCTLs verwenden.
Die folgende Liste beschreibt die interne Struktur und Funktion einer Sammlung auf oberster Ebene:
- Eine HIDP_CAPS Struktur fasst die Funktion einer Auflistung auf oberster Ebene zusammen.
- Linksammlungen beschreiben die Organisation der geschachtelten Sammlungen, die in einer Auflistung auf oberster Ebene enthalten sind.
- Schaltflächenfunktionsarrays und Wertfunktionsarrays beschreiben die Funktion der Steuerelemente, die von der Sammlung der obersten Ebene unterstützt werden.