HIDP_BUTTON_CAPS-Struktur (hidpi.h)

Die HIDP_BUTTON_CAPS-Struktur enthält Informationen über die Funktionen einer HID-Steuerelementschaltfläche (oder einer Reihe von Schaltflächen, die einem Nutzungsbereich zugeordnet sind).

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;
  USHORT  ReportCount;
  USHORT  Reserved2;
  ULONG   Reserved[9];
  union {
    struct {
      USAGE  UsageMin;
      USAGE  UsageMax;
      USHORT StringMin;
      USHORT StringMax;
      USHORT DesignatorMin;
      USHORT DesignatorMax;
      USHORT DataIndexMin;
      USHORT DataIndexMax;
    } Range;
    struct {
      USAGE  Usage;
      USAGE  Reserved1;
      USHORT StringIndex;
      USHORT Reserved2;
      USHORT DesignatorIndex;
      USHORT Reserved3;
      USHORT DataIndex;
      USHORT Reserved4;
    } NotRange;
  };
} HIDP_BUTTON_CAPS, *PHIDP_BUTTON_CAPS;

Member

UsagePage

Gibt die Nutzungsseite für einen Nutzungsbereich oder einen Nutzungsbereich an.

ReportID

Gibt die Berichts-ID des HID-Berichts an, der den Verwendungsbereich oder den Nutzungsbereich enthält.

IsAlias

Gibt an, wenn TRUE, dass eine Schaltfläche über eine Reihe von Aliasverwendungen verfügt. Wenn IsAliasauf FALSE festgelegt ist, hat die Schaltfläche nur eine Verwendung.

BitField

Enthält die Datenfelder (ein oder zwei Bytes), die einer Eingabe, Ausgabe oder einem Feature Standard Element zugeordnet sind.

LinkCollection

Gibt den Index der Linkauflistung im Linksammlungsarray einer Auflistung der obersten Ebene an, das den Verwendungsbereich oder den Verwendungsbereich enthält. Wenn LinkCollection null ist, ist der Verwendungsbereich oder der Verwendungsbereich in der Auflistung der obersten Ebene enthalten.

LinkUsage

Gibt die Verwendung der Linkauflistung an, die die Verwendung oder den Nutzungsbereich enthält. Wenn LinkCollection null ist, gibt LinkUsage die Verwendung der Auflistung der obersten Ebene an.

LinkUsagePage

Gibt die Verwendungsseite der Linkauflistung an, die die Verwendung oder den Nutzungsbereich enthält. Wenn LinkCollection null ist, gibt LinkUsagePage die Verwendungsseite der Sammlung der obersten Ebene an.

IsRange

Gibt an, wenn TRUE, dass die Struktur einen Verwendungsbereich beschreibt. Wenn IsRangeauf FALSE festgelegt ist, beschreibt die -Struktur andernfalls eine einzelne Verwendung.

IsStringRange

Gibt an, wenn TRUE, dass der Verwendungsbereich oder der Verwendungsbereich über einen Satz von Zeichenfolgendeskriptoren verfügt. Andernfalls weist der Verwendungsbereich null oder einen Zeichenfolgendeskriptor auf, wenn IsStringRangeAUF FALSE festgelegt ist.

IsDesignatorRange

Gibt an, wenn TRUE, dass der Verwendungsbereich oder der Verwendungsbereich über einen Satz von Bezeichnern verfügt. Wenn IsDesignatorRangeauf FALSE festgelegt ist, weist der Verwendungsbereich oder den Verwendungsbereich 0 oder einen Bezeichner auf.

IsAbsolute

Gibt bei TRUE an, dass die Schaltflächennutzung oder der Nutzungsbereich absolute Daten bereitstellt. Wenn IsAbsoluteauf FALSE festgelegt ist, sind die Schaltflächendaten die Änderung des Zustands gegenüber dem vorherigen Wert.

ReportCount

Durch HID definierte Berichtsanzahl. Verfügbar ab API-Version 2.0. Rufen Sie die funktion HIDP_GetVersion auf, um die API-Version abzurufen.

Reserved2

Reserviert für die interne Systemverwendung.

Reserved[9]

Reserviert für die interne Systemverwendung.

Range

Gibt an, wenn IsRangeTRUE ist, Informationen zu einem Nutzungsbereich. Andernfalls enthält NotRange, wenn IsRangeFALSE ist, Informationen zu einer einzelnen Verwendung.

Range.UsageMin

Gibt die inklusive Untergrenze des Nutzungsbereichs an, dessen inklusive Obergrenze durch Range.UsageMax angegeben wird.

Range.UsageMax

Gibt die inklusive Obergrenze eines Nutzungsbereichs an, dessen inklusive Untergrenze durch Range.UsageMin angegeben wird.

Range.StringMin

Gibt die inklusive Untergrenze eines Bereichs von Zeichenfolgendeskriptoren an (angegeben durch Zeichenfolgen-Minimum- und Zeichenfolgenmaximierungselemente), deren inklusive Obergrenze durch Range.StringMax angegeben wird.

Range.StringMax

Gibt die inklusive Obergrenze eines Bereichs von Zeichenfolgendeskriptoren an (angegeben durch Zeichenfolgen-Minimum- und Zeichenfolgenmaximierungselemente), deren inklusive Untergrenze durch Range.StringMin angegeben wird.

Range.DesignatorMin

Gibt die inklusive Untergrenze eines Bereichs von Bezeichnern an (angegeben durch die Elemente des Minimal- und Designatormaximums), deren inklusive Untergrenze durch Range.DesignatorMax angegeben wird.

Range.DesignatorMax

Gibt die inklusive Obergrenze eines Bereichs von Bezeichnern an (angegeben durch die Elemente des Minimal- und Bezeichnermaximums), deren inklusive untere Grenze durch Range.DesignatorMin angegeben wird.

Range.DataIndexMin

Gibt die inklusive Untergrenze eines sequenziellen Datenindexbereichs an, der 1:1 und in derselben Reihenfolge den Im Nutzungsbereich Range.UsageMin bis Range.UsageMax angegebenen Nutzungen entspricht.

Range.DataIndexMax

Gibt die inklusive Obergrenze eines sequenziellen Datenindexbereichs an, der 1:1 und in derselben Reihenfolge den im Nutzungsbereich Range.UsageMin bis Range.UsageMax angegebenen Verwendungen entspricht.

NotRange

Gibt an, wenn IsRangeauf FALSE festgelegt ist, Informationen zu einer einzelnen Verwendung. Andernfalls enthält Range, wenn IsRangeTRUE ist, Informationen zu einem Nutzungsbereich.

NotRange.Usage

Gibt eine Nutzungs-ID an.

NotRange.Reserved1

Reserviert für die interne Systemverwendung.

NotRange.StringIndex

Gibt eine Zeichenfolgendeskriptor-ID für die von NotRange.Usage angegebene Verwendung an.

NotRange.Reserved2

Reserviert für die interne Systemverwendung.

NotRange.DesignatorIndex

Gibt eine Bezeichner-ID für die von NotRange.Usage angegebene Verwendung an.

NotRange.Reserved3

Reserviert für die interne Systemverwendung.

NotRange.DataIndex

Gibt den Datenindex der von NotRange.Usage angegebenen Verwendung an.

NotRange.Reserved4

Reserviert für die interne Systemverwendung.

Hinweise

Clients erhalten ein Schaltflächenfunktionsarray , indem sie HidP_GetButtonCaps oder HidP_GetSpecificButtonCaps aufrufen. Diese Routinen geben ein Array von HIDP_BUTTON_CAPS Strukturen in einem vom Aufrufer zugewiesenen Puffer zurück. Die erforderliche Pufferlänge wird in der HIDP_CAPS-Struktur angegeben, die von HidP_GetCaps zurückgegeben wird.

Informationen zu den Funktionen von HID-Steuerelementwerten finden Sie unter Sammlungsfunktions- und Wertfunktionsarrays.

Wenn ein Berichtsdeskriptor ein Eingabe-, Ausgabe- oder Feature-Standard Element mit weniger Verwendungsdeklarationen als reportCount deklariert, gilt die letzte Verwendung für alle verbleibenden nicht angegebenen Zähler in diesem Standard Element. Beispielsweise verfügen Sie möglicherweise über Daten, für die viele Felder beschrieben werden müssen, möglicherweise gepufferte Bytes. In diesem Fall wird nur eine Value Cap-Struktur für diese zugeordneten Felder zugeordnet, die alle die gleiche Verwendung aufweisen, und ReportCount gibt die Anzahl der beteiligten Felder an. Normalerweise ist ReportCount eins. Um auf alle Felder in einer solchen Wertstruktur zuzugreifen, müssten HidP_GetUsageValueArray und HidP_SetUsageValueArray verwendet werden. Die funktionen HidP_GetUsageValue und HidP_SetScaledUsageValue funktionieren ebenfalls. Diese Funktionen funktionieren jedoch nur mit dem ersten Feld der -Struktur.

Anforderungen

Weitere Informationen

• HIDP_CAPS
• HIDP_VALUE_CAPS
• HidP_GetButtonCaps
• HidP_GetCaps
• HidP_GetSpecificButtonCaps
• HidP_GetSpecificValueCaps
• HidP_GetValueCaps