HIDP_BUTTON_CAPS

9/8/2008

Essa estrutura contém informações sobre a funcionalidade de um uso botão controle HID ou um conjunto de botões associado com um intervalo de uso.

Syntax

typedef struct _HIDP_BUTTON_CAPS {
  USAGE UsagePage;
  UCHAR ReportID;
  BOOLEAN IsAlias;
  USHORT BitField;
  USHORT LinkCollection;
  USAGE LinkUsage;
  USAGE LinkUsagePage;
  BOOLEAN IsRange;
  BOOLEAN IsStringRange;
  BOOLEAN IsDesignatorRange;
  BOOLEAN IsAbsolute;
  ULONG Reserved[10];
  union {
    struct {
      USAGE UsageMin, UsageMax;
      USHORT StringMin, StringMax;
      USHORT DesignatorMin, DesignatorMax;
      USHORT DataIndexMin, DataIndexMax;
    } Range;
    struct {
      USAGE Usage, Reserved1;
      USHORT StringIndex, Reserved2;
      USHORT DesignatorIndex, Reserved3;
      USHORT DataIndex, Reserved4;
    } NotRange;
  };
} HIDP_BUTTON_CAPS, * PHIDP_BUTTON_CAPS;

Os membros

• UsagePage
  Página de uso para um uso ou intervalo de uso.

• ReportID
  Identificador de relatório do relatório HID que contém o uso ou intervalo de uso.

• IsAlias
  Indicador de uso do botão. Se TRUE, um botão tem um conjunto de usos de alias. Se FALSE, o botão tem somente um uso.

• BitField
  Campos de dados de um ou dois bytes associado com uma entrada, saída ou recurso item principal.

• LinkCollection
  O índice da coleção link em uma de alto nível link coleção matriz da coleção que contém o uso ou intervalo de uso. Se LinkCollection for zero, o uso ou intervalo de uso está contido na de alto nível coleção.

• LinkUsage
  Uso da coleção de link que contém o uso ou intervalo de uso. Se LinkCollection for zero, LinkUsage Especifica o uso de de alto nível coleção.

• LinkUsagePage
  Página de uso da coleção de link que contém o uso ou intervalo de uso. Se LinkCollection for zero, LinkUsagePage Especifica a página de uso do de alto nível coleção.

• IsRange
  Indicador de uso. Se TRUE, a estrutura descreve um intervalo de uso. Se FALSE, a estrutura descreve um uso único.

• IsStringRange
  Indicador descritor de seqüência de caracteres. Se tiver um conjunto de descritores seqüência de caracteres TRUE, o uso ou intervalo de uso. Se FALSE, o uso ou intervalo de uso tiver zero ou seqüência de caracteres um descritor.

• IsDesignatorRange
  Indicador do designador de uso. Se TRUE, que o uso ou intervalo de uso tem um conjunto de designadores. Se FALSE, o uso ou intervalo de uso tem zero ou um designador.

• IsAbsolute
  Indicador dados de uso. Se TRUE, que o botão uso ou intervalo de uso fornece dados absolutos. Se FALSE, os dados botão é a alteração no estado do valor anterior.

• Reservado
  Reservado para uso interno sistema.

• Intervalo.UsageMin
  Limite inferior, inclusive do intervalo de uso cujo inclusive limite superior é especificado pelo Range.UsageMax.

• Intervalo.UsageMax
  Limite superior, inclusive de um intervalo de uso cujo inclusive limite inferior é indicada por Range.UsageMin.

• Intervalo.StringMin
  Limite inferior, inclusive de um intervalo de descritores seqüência de caracteres especificado por mínimo seqüência de caracteres e seqüência de caracteres máximo itens cujo inclusive limite superior é indicado por Range.StringMax.

• Intervalo.StringMax
  Limite superior, inclusive de um intervalo de descritores seqüência de caracteres especificado por mínimo seqüência de caracteres e seqüência de caracteres máximo itens cujo inclusive limite inferior é indicado por Range.StringMax.

• Intervalo.DesignatorMin
  Limite inferior, inclusive de um intervalo de designadores especificado por designador mínimo e itens máximo do designador cujo inclusive limite superior é indicada por Range.DesignatorMax.

• Intervalo.DesignatorMax
  Limite superior, inclusive de um intervalo de designadores especificado por designador mínimo e itens máximo do designador cujo inclusive limite inferior é indicada por Range.DesignatorMax.

• Intervalo.DataIndexMin
  Limite inferior, inclusive de um serial intervalo de dados os índices que corresponder, um-para-um e a mesma ordem, para os usos especificados pelo intervalo de uso Range.UsageMin Para Range.UsageMax.

• Intervalo.DataIndexMax
  Limite superior, inclusive de um serial intervalo de dados os índices que corresponder, um-para-um e a mesma ordem, para os usos especificados pelo intervalo de uso Range.UsageMin Para Range.UsageMax.

• Intervalo
  Indicador de uso. Se IsRange é TRUE, informações sobre um intervalo de uso. Se IsRange é FALSE, NotRange Contém informações sobre um uso único.

• **NotRange.**O uso
  Identificador de uso.

• **NotRange.**Reservado1
  Reservado para uso interno sistema.

• **NotRange.**StringIndex
  Indicador de um identificador para o uso especificado pelo descritor seqüência de caracteres NotRange.Usage.

• **NotRange.**Reserved2
  Reservado para uso interno sistema.

• **NotRange.**DesignatorIndex
  Indicador de um identificador do designador para o uso especificado por NotRange.Usage.

• **NotRange.**Reserved3
  Reservado para uso interno sistema

• **NotRange.**DataIndex
  Indicador para o índice do uso especificado por dados NotRange.Usage.

• **NotRange.**Reserved4
  Reservado para uso interno sistema.

• NotRange
  Indicador de uso. Se IsRange é FALSE, informações sobre um uso único. Se IsRange é TRUE, Intervalo Contém informações sobre um intervalo de uso.

Remarks

Os termos botão e o uso são usados como sinônimo.

Os clientes obtêm uma matriz funcionalidade botão, chamado de HidP_GetButtonCaps Ou HidP_GetSpecificButtonCaps função. Essas funções retornam uma matriz de HIDP_BUTTON_CAPS Estruturas em uma reserva Caller-allocated. O HIDP_CAPS estrutura, o qual o HidP_GetCaps função retorna, especifica o exigido tamanho do buffer.

Requirements

Header	hidpi.h
Windows Embedded CE	Windows CE .NET 4.2 and later

See Also

Reference

HIDP_CAPS
HidP_GetButtonCaps
HidP_GetCaps
HidP_GetSpecificButtonCaps
HidP_GetSpecificValueCaps
HidP_GetValueCaps
HIDP_VALUE_CAPS