Değer kapasite dizileri

Değer özelliği dizisi, belirli bir HID raporu türü için en üst düzey koleksiyon tarafından desteklenen değer kullanımları hakkında bilgi içerir. Bir koleksiyonun değer yeteneği dizileri hakkındaki bilgiler , HIDP_CAPS yapısında yer alır.

Kullanıcı modu uygulaması veya çekirdek modu sürücüsü, düğme özelliği bilgilerini almak için aşağıdaki HIDClass destek yordamlarından birini kullanır:

  • HidP_GetValueCaps , çağıran tarafından belirtilen rapor türünde yer alan tüm değerleri açıklayan bir değer yetenek dizisi döndürür.

  • HidP_GetSpecificValueCaps , döndürdüğü değer özelliği bilgilerini arayan tarafından belirtilen kullanım sayfası, kullanım, bağlantı koleksiyonu ve rapor türüne göre filtreler.

Değer özelliği dizisi, her biri HID kullanımı veya kullanım aralığı hakkında aşağıdaki bilgileri açıklayan HIDP_VALUE_CAPS yapıları içerir:

  • Bir kullanım veya kullanım aralığı için kullanım sayfası

  • Değeri içeren raporun rapor kimliği

  • Kullanım kimliği veya kullanım aralığı

  • Kullanımın aliased kullanım olup olmadığını gösterir

  • Kullanım veya kullanım aralığını içeren bağlantı koleksiyonu hakkında bilgi

  • Bir değerin bit cinsinden boyutu ve rapor sayısı (yapı tarafından açıklanan tek tek değerlerin sayısıdır)

  • Her bir değerin nitelikleri şunlardır: null değere sahip olup olmadığı, birimleri ve üssü, ayrıca mantıksal ve fiziksel aralıkları.

  • Kullanım veya kullanım aralığıyla ilişkili dize tanımlayıcıları ve belirleyicileri hakkında bilgi

  • HID ayrıştırıcısının bir kullanım veya kullanım aralığı atamış olduğu veri dizinleri hakkında bilgi

Genel olarak, aşağıdaki koşullar bir değer yetenek dizisi tarafından açıklanan tüm kullanımlar için geçerlidir:

  • Her özellik yapısı, değişken ana öğesiyle ilişkili bir kullanımı, kullanım aralığını veya kullanım değeri dizisini temsil eder. Dizi ana öğeleri değerler için desteklenmez.

  • Takma ad kullanımları kullanılabilir. Kullanım aralığına takma ad verilemez. Bir adla anılan değerler, bir düğme yetenek dizisinde adla anılan düğmelerin birbirine bağlanması gibi, bir değer yetenek dizisinde birbirine bağlanır. Bkz. Değişken Ana Öğesinde Düğme Kullanımları.

  • HID ayrıştırıcısı, her değere bir kullanım atamak için yalnızca gerekli en düşük kullanımları kullanır. Ayrıştırıcı, kullanımları bir rapor tanımlayıcısında belirtildikleri sırayla atar. Bir rapor tanımlayıcısında gerekli olmayan kullanımlar atılır. Değer özelliği dizisi, atılan kullanımlar hakkında herhangi bir bilgi içermez.

  • HID ayrıştırıcısı, yetenek dizisinde açıklanan her kullanıma benzersiz bir veri dizini atar.

Veri dizinlerinin değerlere nasıl atandığı hakkında bir açıklama için bkz. Veri Dizinleri.

Kullanım değeri dizisi

Kullanım değeri dizisi, ana öğede belirtilen ardışık bir değer kümesidir ve bunların tümüne aynı kullanım atanır. Bu durum, rapor sayısı birden fazla olan bir ana öğe için yalnızca bir kullanım belirtilirse oluşur.

Aşağıdaki şekilde, her altı bit uzunluğunda beş veri öğesi içeren bir kullanım değeri dizisi örneği gösterilmektedir.

Her 6 bit uzunluğunda beş veri öğesi içeren bir kullanım değeri dizisini gösteren diyagram.

Önceki örnekte, bu tür bir kullanım değeri dizisi için değer kabiliyeti yapısında, IsRange üyesi FALSE, NotRange.Usage üyesi 17, ReportCount üyesi 5 ve BitSize üyesi 6 olarak ayarlanmıştır.

Bir kullanımın rapor sayısı 1 ise, kullanım değerini ayıklamak için HidP_GetUsageValue kullanın. Kullanımın rapor sayısı 1'den büyükse , HidP_GetUsageValue yalnızca kullanım değeri dizisindeki ilk veri öğesini döndürür. Kullanım değeri dizisindeki tüm veri öğelerini ayıklamak için HidP_GetUsageValueArray kullanın.

  • Last updated on