Aracılığıyla paylaş

Düğme fonksiyonu dizileri

Düğme özelliği dizisi, belirli bir HID raporu türü için en üst düzey koleksiyon tarafından desteklenen düğme kullanımları hakkında bilgi içerir. Bir koleksiyonun özelliği 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_GetButtonCaps , belirtilen rapor türünde yer alan tüm düğme kullanımlarını açıklayan bir düğme özelliği dizisi döndürür.

  • HidP_GetSpecificButtonCaps , çağıran tarafından belirtilen kullanım sayfası, kullanım kimliği ve bağlantı koleksiyonu tarafından döndürdüğü düğme özelliği bilgilerini filtreler.

Düğme yetenek dizisi, her biri HID kullanımı veya kullanım aralığı hakkında aşağıdaki bilgileri içeren HIDP_BUTTON_CAPS yapıları içerir:

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

  • Düğme verilerini içeren raporun rapor kimliği

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

  • Kullanımın takma ad kullanımı olup olmadığını gösteren bayrak

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

  • Kullanım veya kullanım aralığıyla ilişkili dize tanımlayıcıları ve belirleyicileri (bkz. Belirleyici Dizin öğesi ve Dize Dizini öğesi)

  • HID ayrıştırıcısının kullanım veya kullanım aralığına atadığı veri dizinleri

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

  • Her yetenek yapısı, bir değişken ana öğesi veya dizi ana öğesiyle ilişkili tek bir kullanımı veya kullanım aralığını temsil eder.

  • Takma ad kullanımları değişken bir öğe ile kullanılabilir. Bir dizi öğesiyle ilişkilendirilmiş bir kullanım diğer ad yapılamaz. Kullanım aralığına takma ad verilemez.

  • HID ayrıştırıcısı, her düğmeye bir kullanım atamak için yalnızca gerekli en düşük kullanım sayısını 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. Düğme yetenek dizisi, atılmış kullanımlar hakkında herhangi bir bilgi içermez.

  • Değişken öğesi için belirtilen kullanım sayısı öğedeki düğme sayısından azsa, yetenek dizisi tek düğme kullanımını açıklayan yalnızca bir yetenek yapısı içerir (değişken ana öğesi için rapor tanımlayıcısında belirtilen son kullanım). Ancak, rapor sayısı birden fazla olan kullanım değerleri hakkında bilgi için bkz . Kullanım Değeri Dizisi .

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

Aşağıdaki konular, yetenek yapılarının bir düğme yetenek dizisinde nasıl düzenlenip ayarlandığını açıklar:

Değişken ana öğesindeki düğme kullanımları

Bir rapor tanımlayıcısında belirtilen her kullanım veya kullanım aralığı , düğme yetenek dizisindeki kendi yetenek yapısıyla açıklanır.

Yetenek yapılarına ait IsAlias üyesi, aşağıdaki şekilde n adet takma ad kullanımı belirtmek için kullanılır:

  • IsAlias, yetenek dizisine eklenen ilk n-1 yetenek yapılarında TRUE olarak ayarlanır. IsAlias, n yetenek yapısında FALSE olarak ayarlanmıştır. Sıralamada tercih edilen kullanım, en son diğer adlandırılmış kullanımdır.

Bir uygulama veya sürücü, bu tür diziler için tarama yaparak hangi düğme kullanımlarının diğer adlara sahip olduğunu belirleyebilir.

Aşağıdaki tabloda üç takma ad kullanımı örneği özetlenmiştir.

Rapor tanımlayıcısında diğer adla kullanım sırası Yetenek dizisindeki kullanım sırası IsAlias üye değeri
kullanım 1 kullanım 3 DOĞRU
kullanım 2 kullanım 2 DOĞRU
kullanım 3 kullanım 1 YANLIŞ

Kullanımların ve veri dizinlerinin çapraz başvurulma şekli hakkında bilgi için bkz. Veri Dizinleri.

Dizi ana öğesindeki düğme kullanımları

Rapor tanımlayıcısında belirtilen bir düğme dizisi ana öğesi için her kullanım veya kullanım aralığı , düğme yetenek dizisindeki kendi yetenek yapısıyla açıklanır. Yetenek yapılarının bir yetenek dizisine eklenme sırası, bir ana öğe için kullanımların belirtildiği sıranın tersidir.

HID ayrıştırıcısı, dizi öğesiyle ilişkili her kullanıma, kullanımların bir rapor tanımlayıcısında belirtildiği sırada bir veri dizini atar. Örneğin, aşağıdaki tabloda, bir rapor tanımlayıcısında belirtildiği gibi bir kullanım kümesi ile özellik dizisinde belirtildiği gibi kullanımlar ve veri dizinleri arasındaki yazışmalar gösterilmektedir. (Bu tabloda n , ayrıştırıcının dizi öğesiyle ilişkili ilk kullanıma atadığını ilk veri dizinidir.)

Rapor tanımlayıcısında kullanım sırası Yetenek dizisindeki kullanım sırası DataIndex veya DataIndexMin'den DataIndexMax'a
kullanım 1 kullanım aralığı 2 n+7 ile n+8 arasında
kullanım aralığı 1 (4 kullanım ile) kullanım 2 n+5
kullanım 2 kullanım aralığı 1 n+1 ile n+4 arasında
kullanım kapsamı 2 (2 kullanıma sahip) kullanım 1 n
  • Last updated on