HID Link Collections

9/8/2008

Uma coleção link é uma coleção aninhada dentro uma de alto nível coleção. Um de alto nível coleção pode ter zero ou mais coleções link.

O HidP_GetLinkCollectionNodes função retorna uma de alto nível link coleção matriz da coleção, que contém informações sobre um de alto nível coleções da coleção link.

Matrizes da coleção de links

Uma matriz coleção link descreve todas as coleções link contidas em um de alto nível coleção. Um HIDP_LINK_COLLECTION_NODE estrutura representa uma coleção link. Identifica a organização de nós da matriz link da coleção a link serial e hierárquico ordem dentro uma de alto nível coleção. O primeiro elemento de uma matriz coleção link representa um de alto nível coleção e os membros restantes representam o de alto nível coleções da coleção link.

Por atravessando por nós na matriz conexão link, um driver cliente HID pode determinar a organização e uso de todas as coleções link em um de alto nível coleção. Além disso, o driver pode organizar controles por seus associado coleções link. Isso é possível porque uma de alto nível da coleção matrizes funcionalidade botão e matrizes funcionalidade valor identificam a link coleção que contém cada uso HID descrito por matrizes de funcionalidade.

Nós da coleção de links

Link coleções link juntos em um parte superior - para - inferior e esquerda - para - direito ordem.

A seguinte tabela mostra os relacionamentos de nós diferentes em uma matriz coleção link.

Elemento de matriz	Descrição
Pai	Pai de uma coleção é a coleção imediatamente acima de coleção na parte superior - para - hierarquia inferior. Coleções vínculo tem um pai. O Pai membro de um nó link especifica o índice de seu pai na matriz a coleção link.
Filhos	Uma coleção link é um filho de seu pai. Um pai pode ter zero ou mais filhos. O NumberOfChildren membro de uma estrutura nó link especifica o número de filhos do pai dessa estrutura.
Primeiro filho	O primeiro filho é o irmão da extrema esquerda em um conjunto de irmãos. O FirstChild membro de um nó coleção link especifica o índice para seu primeiro filho na matriz a coleção link. Se um nó coleção link tiver não filhos, FirstChild é zero.
Irmão	Todos os filhos de um pai são irmãos.
Próximo irmão	Irmãos são ordenados de esquerda para a direita. Se houver mais irmão, o irmão para o direito imediato é o primeiro irmão. O NextSibling membro de um nó coleção link especifica o índice para o próximo irmão na matriz a coleção link. Se um nó coleção link não tem um próximo irmão, NextSibling é zero.

Um driver cliente HID pode determinar filhos de uma coleção pai iniciando com primeiro filho do pai e, em seguida, atravessando através de irmãos do primeiro filho até a NextSibling membro de um nó irmão é zero.

O seguinte exemplo de código mostra como usar um link coleção nó índice para localizar o primeiro filho do link coleção sete.

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

Coleções com alias

Um dispositivo pode usar delimitador itens em seu descritor relatório para delimitar um conjunto de coleções de alias. Um alias link coleção nó representa cada coleção de alias.

A seguinte lista mostra como um completo e exclusivo definido do link more than dois nós alias juntos:

• Nós com alias estão na ordem consecutiva na matriz a coleção link.
• EXCEPT for do o último alias nó, cada nó IsAlias membro é TRUE.
• Do nó a última IsAlias membro é FALSE.
• O último nó Termina a seqüência de nós de alias.
• O associado de uso com o último nó é o uso preferencial.

Um driver cliente pode determinar quais coleções são alias pelo incremento repetidamente a índice de matriz de uma matriz coleção link para localizar essas seqüências.

Cada uso que botão funcionalidade matrizes e matrizes funcionalidade valor descrevem identifica a coleção link que contém o uso. Se uma coleção link for alias, a funcionalidade matriz especificar o uso preferencial.