Koleksiyonları bağlama

Bağlantı koleksiyonu, bir üst düzey koleksiyon içinde iç içe bir alt koleksiyon olarak yer alır. En üst düzey koleksiyonda sıfır veya daha fazla bağlantı koleksiyonu olabilir.

HidP_GetLinkCollectionNodes , bir üst düzey koleksiyonun bağlantı koleksiyonları hakkında bilgi içeren bir üst düzey koleksiyonun bağlantı koleksiyonu dizisini döndürür.

Bağlantı koleksiyonu dizisi, bir üst düzey koleksiyon içinde yer alan tüm bağlantı koleksiyonlarını açıklar. Her bağlantı koleksiyonu bir HIDP_LINK_COLLECTION_NODE yapısıyla temsil edilir. Dizinin bağlantı düğümleri, en üst düzey koleksiyon içinde sıralı ve hiyerarşik sıralarını tanımlayan bir şekilde bağlanır. Bağlantı koleksiyonu dizisinin ilk öğesi bir üst düzey koleksiyonu, kalan üyeler ise en üst düzey koleksiyonun bağlantı koleksiyonlarını temsil eder.

Bağlantı bağlantısı dizisindeki düğümler arasında izleme yaparak, kullanıcı modu uygulaması veya çekirdek modu sürücüsü, en üst düzey koleksiyondaki tüm bağlantı koleksiyonlarının kuruluşunu ve kullanımını belirleyebilir. Buna ek olarak, uygulama veya sürücü denetimleri kendi bağlantı koleksiyonuna göre düzenleyebilir. Bu mümkündür çünkü bir üst düzey koleksiyonun düğme yetenek dizileri ve değer yeteneği dizileri, özellik dizileri tarafından açıklanan her HID kullanımını içeren bağlantı koleksiyonunu tanımlar.

Aşağıdaki şekilde, dört bağlantı koleksiyonu içeren bir üst düzey koleksiyon örneği gösterilmektedir.

Dört bağlantı koleksiyonu içeren üst düzey koleksiyonu gösteren diyagram.

Önceki şekilde belirtildiği gibi, bağlantı koleksiyonları yukarıdan aşağıya ve soldan sağa sırada (ABCD) birbirine bağlanır. Aşağıdaki tabloda, örnekteki her bağlantı koleksiyonu için en üst düzey koleksiyon ile bağlantı koleksiyonları arasındaki bağlantılar gösterilir.

Bağlantı Düğümü Ebeveyn Children İlk Çocuk Öğe Sonraki Kardeş
A Üst Düzey Koleksiyon B, C B Hiç kimse
B A D D C
C A Hiç kimse Hiç kimse Hiç kimse
D B Hiç kimse Hiç kimse Hiç kimse

Bağlantı koleksiyonu dizisinde aşağıdaki tanımlar geçerlidir:

  • Üst öğe: Bir bağlantı koleksiyonunun üst öğesi , koleksiyonların yukarıdan aşağıya hiyerarşisinde hemen üstündeki koleksiyondur. Bağlantı koleksiyonlarının bir ebeveyni vardır. Bağlantı düğümünün Üst üyesi, bağlantı koleksiyonu dizisindeki üst öğesinin dizinini belirtir.

  • Çocuk: Bağlantı koleksiyonu, ebeveyninin çocuğudur. Bir ebeveynin sıfır veya daha fazla çocuğu olabilir. Bağlantı düğümünün NumberOfChildren üyesi, bir ebeveynin sahip olduğu alt düğüm sayısını belirtir.

  • Eşdüzey: Ebeveynin çocukları kardeştir.

  • Sonraki Kardeş: Kardeşler soldan sağa sıralanır. Bir kardeşin bir sonraki kardeşi, varsa, kendisinin sağındaki kardeştir. Bağlantı koleksiyonu düğümünün NextSibling üyesi, bağlantı koleksiyonu dizisindeki bir sonraki kardeşinin indeksini belirtir. Bir bağlantı koleksiyonu düğümünde bir sonraki eşdüzey yoksa , NextSibling sıfır olarak ayarlanır.

  • İlk Çocuk: İlk çocuk, bir grup kardeşte en soldaki kardeştir. Bağlantı koleksiyonu düğümünün FirstChild üyesi, bağlantı koleksiyonu dizisindeki ilk alt öğesinin dizinini belirtir. Bağlantı koleksiyonu düğümünde alt öğe yoksa, FirstChild sıfır olarak ayarlanır.

Bir uygulama veya sürücü, bir üst koleksiyonun tüm alt öğelerini, ilk alt öğesinden başlayarak, ve ilk çocuğun kardeşlerini sıralayarak, bir kardeş düğümünün NextSibling üyesi sıfır olana kadar belirleyebilir.

Aşağıdaki kod, bağlantı koleksiyonu yedisinin ilk alt öğesini bulmak için bir bağlantı koleksiyonu düğüm dizininin nasıl kullanılacağını gösterir.

HIDP_LINK_COLLECTION_NODE Collection[10] ;
HIDP_LINK_COLLECTION_NODE Node1 ;
 
Node1 = Collection[Collection[7].FirstChild];

Başka adla kullanılan koleksiyonlar

Sınırlayıcı öğeler, takma adlı koleksiyonlar kümesini sınırlandırmak için bir rapor tanımlayıcısında kullanılabilir. Diğer adla eklenen her koleksiyon, bir diğer adla bağlantı koleksiyonu düğümüyle temsil edilir. N, n>=2, diğer adlara sahip düğümlerin tam ve benzersiz bir kümesi aşağıdaki şekilde birbirine bağlanır:

  • Diğer adlara sahip düğümler, bağlantı koleksiyonu dizisinde ardışık sıradadır.

  • İlk n-1 düğümlerinin IsAlias üyesi TRUE olarak ayarlanmıştır. Böyle bir diziden hemen sonra gelen n'inci düğümün IsAlias üyesi FALSE olarak ayarlanmıştır. Bu düğüm, diğer adla belirtilen düğümlerin sırasını sonlandırır. Bu düğümle ilişkili kullanım tercih edilen kullanımdır.

Bir uygulama veya sürücü, bu tür dizileri bulmak için bir bağlantı koleksiyonu dizisinin dizi dizinini art arda artırarak hangi koleksiyonların diğer adlara sahip olduğunu belirleyebilir.

Düğme yetenek dizileri ve değer yeteneği dizileri , tanımladıkları her kullanım için kullanımı içeren bağlantı koleksiyonunu tanımlar. Bağlantı koleksiyonu diğer adla belirtilirse, özellik dizileri tercih edilen kullanımı belirtir.

  • Last updated on