Pole schopností hodnot

Pole schopností hodnot obsahuje informace o podpoře využití hodnot kolekcí nejvyšší úrovně pro konkrétní typ sestavy HID. Informace o polech schopností hodnot kolekce jsou obsaženy ve struktuře HIDP_CAPS .

Aplikace v uživatelském režimu nebo ovladač režimu jádra používá jednu z následujících rutin podpory HIDClass k získání informací o schopnostech tlačítka:

• HidP_GetValueCaps vrátí pole schopností hodnot popisující všechny hodnoty obsažené v typu sestavy určeném volajícím.

• HidP_GetSpecificValueCaps filtruje informace o možnostech hodnoty, které vrací, podle stránkování využití, použití, shromažďování odkazů a typu reportu, které určil volající.

Pole hodnot schopností obsahuje struktury HIDP_VALUE_CAPS, z nichž každá popisuje následující informace o HID využití nebo rozsahu využití:

• Stránka použití pro použití nebo rozsah použití

• ID zprávy, která obsahuje hodnotu

• ID využití nebo rozsah využití

• Určuje, jestli se jedná o aliasované využití.

• Informace o kolekci odkazů, která obsahuje využití nebo rozsah využití

• Velikost hodnoty, v bitech, a počet záznamů (což je počet jednotlivých hodnot popsaných strukturou)

• Atributy každé hodnoty, včetně: zda má hodnotu null, její jednotky a exponent a logické a fyzické rozsahy

• Informace o popisovačích řetězců a designátorech přidružených k využití nebo rozsahu využití.

• Informace o datových indexech , které analyzátor HID přiřazuje využití nebo rozsah využití

Obecně platí, že následující podmínky se vztahují na veškerá využití popsaná polem schopností hodnot.

• Každá struktura schopností představuje využití, rozsah využití nebo pole hodnot využití , které je přidruženo k proměnné hlavní položky. Primární prvky pole nejsou pro hodnoty podporovány.

• Aliasované využití může být použito. Rozsah využití nelze aliasovat. Aliasované hodnoty jsou propojeny v poli schopností hodnot stejným způsobem jako tlačítka spojená v poli schopností tlačítek. Viz použití tlačítek u proměnné hlavní položky.

• Analyzátor HID používá pouze minimální požadované využití k přiřazení využití ke každé hodnotě. Analyzátor přiřazuje použití v pořadí, ve kterém jsou zadány v deskriptoru hlášení. Použití v popisovači sestavy, které nejsou povinné, se zahodí. Pole schopností hodnoty neobsahuje žádné informace o zahozených využitích.

• Analyzátor HID přiřadí každému použití popsanému v poli schopností jedinečný index dat .

Popis přiřazení datových indexů k hodnotám naleznete v tématu Indexy dat.

Pole hodnot využití

Pole hodnot využití je po sobě jdoucí sada hodnot zadaných v hlavní položce, z nichž všechny mají přiřazené stejné využití. K tomu dochází, pokud je pro hlavní položku, která má počet sestav větší než jeden, zadáno pouze jedno použití.

Následující obrázek ukazuje příklad pole hodnot využití, které obsahuje pět datových položek, každý šest bitů dlouhý.

V předchozím příkladu by struktura schopností hodnoty pro takové pole hodnot využití měla člen IsRange nastaven na FALSE, jeho NotRange.Usage člen nastaven na 17, člen ReportCount nastaven na 5 a jeho BitSize člen nastaven na 6.

Pokud je počet sestav pro určité využití 1, použijte HidP_GetUsageValue k extrakci hodnoty využití. Pokud je počet použití větší než 1, HidP_GetUsageValue vrátí pouze první položku v poli hodnot využití. Pokud chcete extrahovat všechny datové položky v poli hodnot využití, použijte HidP_GetUsageValueArray.