HIDP_VALUE_CAPS-Struktur (hidpi.h)

Artikel
02/26/2024

Die HIDP_VALUE_CAPS-Struktur enthält Informationen, die die Funktion eines Satzes von HID-Steuerelementwerten (entweder eine einzelne Verwendung oder einen Verwendungsbereich) beschreiben.

Syntax

typedef struct _HIDP_VALUE_CAPS {
  USAGE   UsagePage;
  UCHAR   ReportID;
  BOOLEAN IsAlias;
  USHORT  BitField;
  USHORT  LinkCollection;
  USAGE   LinkUsage;
  USAGE   LinkUsagePage;
  BOOLEAN IsRange;
  BOOLEAN IsStringRange;
  BOOLEAN IsDesignatorRange;
  BOOLEAN IsAbsolute;
  BOOLEAN HasNull;
  UCHAR   Reserved;
  USHORT  BitSize;
  USHORT  ReportCount;
  USHORT  Reserved2[5];
  ULONG   UnitsExp;
  ULONG   Units;
  LONG    LogicalMin;
  LONG    LogicalMax;
  LONG    PhysicalMin;
  LONG    PhysicalMax;
  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_VALUE_CAPS, *PHIDP_VALUE_CAPS;

Member

UsagePage

Gibt die Verwendungsseite des Nutzungsbereichs oder des Nutzungsbereichs an.

ReportID

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

IsAlias

Gibt an, wenn TRUE, dass die Verwendung Mitglied einer Reihe von Aliasverwendungen ist. Andernfalls hat der Wert, wenn IsAliasFALSE ist, 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 an, wenn TRUE, dass der Nutzungsbereich oder der Nutzungsbereich absolute Daten bereitstellt. Wenn IsAbsoluteauf FALSE festgelegt ist, ist der Wert die Änderung des Zustands gegenüber dem vorherigen Wert.

HasNull

Gibt an, wenn TRUE, dass die Verwendung einen NULL-Wert unterstützt, der angibt, dass die Daten ungültig sind und ignoriert werden sollen. Andernfalls weist die Verwendung keinen NULL-Wert auf, wenn HasNullauf FALSE festgelegt ist.

Reserved

Reserviert für die interne Systemverwendung.

BitSize

Gibt die Größe des Datenfelds eines Nutzungsdatenfelds in bits in einem Bericht an. Wenn ReportCount größer als eins ist, verfügt jede Verwendung über ein separates Datenfeld dieser Größe.

ReportCount

Gibt die Anzahl der Verwendungen an, die in dieser Struktur beschrieben werden.

Reserved2[5]

Reserviert für die interne Systemverwendung.

UnitsExp

Gibt den Exponenten der Verwendung an, wie im USB HID-Standard beschrieben.

Units

Gibt die Nutzungseinheiten an, wie im USB HID Standard beschrieben.

LogicalMin

Gibt die signierte Untergrenze einer Verwendung an.

LogicalMax

Gibt die signierte Obergrenze einer Verwendung an.

PhysicalMin

Gibt die signierte Untergrenze einer Verwendung an, nachdem die Skalierung auf den logischen Mindestwert angewendet wurde.

PhysicalMax

Gibt die signierte Obergrenze einer Verwendung an, nachdem die Skalierung auf den logischen Maximalwert angewendet wurde.

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 Wertfunktionsarray , indem sie HidP_GetValueCaps oder HidP_GetSpecificValueCaps aufrufen. Diese Routinen geben ein Array von HIDP_VALUE_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.