HIDP_VALUE_CAPS 구조체(hidpi.h)

아티클
02/26/2024

HIDP_VALUE_CAPS 구조에는 HID 컨트롤 값 집합(단일 사용량 또는 사용 범위)의 기능을 설명하는 정보가 포함되어 있습니다.

구문

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;

멤버

UsagePage

사용량 또는 사용 범위의 사용 페이지를 지정합니다.

ReportID

사용량 또는 사용 범위가 포함된 HID 보고서의 보고서 ID를 지정합니다.

IsAlias

TRUE이면 사용법이 별칭이 지정된 사용량 집합의 멤버임을 나타냅니다. 그렇지 않으면 IsAlias 가 FALSE이면 값에 사용량이 하나만 있습니다.

BitField

입력, 출력 또는 기능 기본 항목과 연결된 데이터 필드(1~2바이트)를 포함합니다.

LinkCollection

사용량 또는 사용 범위를 포함하는 최상위 컬렉션의 링크 컬렉션 배열에서 링크 컬렉션의 인덱스를 지정합니다. LinkCollection이 0이면 사용량 또는 사용 범위가 최상위 컬렉션에 포함됩니다.

LinkUsage

사용량 또는 사용 범위가 포함된 링크 컬렉션의 사용을 지정합니다. LinkCollection이 0이면 LinkUsage는 최상위 컬렉션의 사용을 지정합니다.

LinkUsagePage

사용량 또는 사용 범위가 포함된 링크 컬렉션의 사용 페이지를 지정합니다. LinkCollection이 0이면 LinkUsagePage는 최상위 컬렉션의 사용 페이지를 지정합니다.

IsRange

구조체가 사용 범위를 설명하는 TRUE인 경우 를 지정합니다. 그렇지 않으면 IsRange 가 FALSE이면 구조체는 단일 사용을 설명합니다.

IsStringRange

TRUE이면 사용량 또는 사용 범위에 문자열 설명자 집합이 있음을 지정합니다. 그렇지 않으면 IsStringRange 가 FALSE이면 사용량 또는 사용 범위에 0개 또는 1개의 문자열 설명자가 있습니다.

IsDesignatorRange

TRUE이면 사용량 또는 사용 범위에 지정자 집합이 있음을 지정합니다. 그렇지 않으면 IsDesignatorRange 가 FALSE이면 사용량 또는 사용 범위에 0개 또는 1개의 지정자가 있습니다.

IsAbsolute

TRUE인 경우 사용량 또는 사용 범위가 절대 데이터를 제공하는지 지정합니다. 그렇지 않으면 IsAbsolute 가 FALSE이면 값은 이전 값의 상태 변경입니다.

HasNull

TRUE이면 사용량이 NULL 값을 지원한다는 것을 지정합니다. 이 값은 데이터가 유효하지 않으며 무시되어야 했음을 나타냅니다. 그렇지 않으면 HasNull 이 FALSE이면 사용량에 NULL 값이 없습니다.

Reserved

내부 시스템 사용을 위해 예약되어 있습니다.

BitSize

보고서에서 사용량 현황 데이터 필드의 크기를 비트 단위로 지정합니다. ReportCount가 1보다 큰 경우 각 사용량에는 이 크기의 별도의 데이터 필드가 있습니다.

ReportCount

이 구조체에서 설명하는 사용 횟수를 지정합니다.

Reserved2[5]

내부 시스템 사용을 위해 예약되어 있습니다.

UnitsExp

USB HID 표준에 설명된 대로 사용량의 지수를 지정합니다.

Units

USB HID 표준에 설명된 대로 사용 단위를 지정합니다.

LogicalMin

사용량의 서명된 하한을 지정합니다.

LogicalMax

사용량의 서명된 상한을 지정합니다.

PhysicalMin

크기 조정이 논리적 최소값에 적용된 후 사용량의 부가 하한을 지정합니다.

PhysicalMax

크기 조정이 논리적 최대값에 적용된 후 사용량의 부가 상한을 지정합니다.

Range

IsRange가 TRUE이면 사용 범위에 대한 정보를 지정합니다. 그렇지 않으면 IsRange 가 FALSE이면 NotRange 에는 단일 사용량에 대한 정보가 포함됩니다.

Range.UsageMin

Range.UsageMax에 의해 포괄 상한이 지정된 사용 범위의 포함 하한을 나타냅니다.

Range.UsageMax

Range.UsageMin으로 포괄 하한이 표시되는 사용 범위의 포함 상한을 나타냅니다.

Range.StringMin

범위 상한이 Range.StringMax로 표시되는 문자열 설명자 범위(문자열 최소 및 문자열 최대 항목으로 지정됨)의 포함 하한을 나타냅니다.

Range.StringMax

포함 하한이 Range.StringMin으로 표시되는 문자열 설명자 범위(문자열 최소 및 문자열 최대 항목으로 지정됨)의 포함 상한을 나타냅니다.

Range.DesignatorMin

포함 하한이 Range.DesignatorMax로 표시되는 지정자 범위(지정자 최소 및 지정자 최대 항목으로 지정됨)의 포함 하한을 나타냅니다.

Range.DesignatorMax

포함 하한이 Range.DesignatorMin으로 표시되는 지정자 범위(지정자 최소 및 지정자 최대 항목으로 지정됨)의 포함 상한을 나타냅니다.

Range.DataIndexMin

Range.UsageMin에서 Range.UsageMax로 지정된 사용량에 해당하는 순차적 데이터 인덱스 범위의 포함 하한을 일 대 일 순서로 나타냅니다.

Range.DataIndexMax

사용 범위 Range.UsageMin에서 Range.UsageMax로 지정된 사용량에 해당하는 순차적 데이터 인덱스 범위의 포함 상한을 나타냅니다.

NotRange

IsRange가 FALSE이면 단일 사용에 대한 정보를 지정합니다. 그렇지 않으면 IsRange 가 TRUE이면 범위 는 사용 범위에 대한 정보를 포함합니다.

NotRange.Usage

사용 ID를 나타냅니다.

NotRange.Reserved1

내부 시스템 사용을 위해 예약되어 있습니다.

NotRange.StringIndex

NotRange.Usage에서 지정한 사용량에 대한 문자열 설명자 ID를 나타냅니다.

NotRange.Reserved2

내부 시스템 사용을 위해 예약되어 있습니다.

NotRange.DesignatorIndex

NotRange.Usage에서 지정한 사용량에 대한 지정자 ID를 나타냅니다.

NotRange.Reserved3

내부 시스템 사용을 위해 예약되어 있습니다.

NotRange.DataIndex

NotRange.Usage에서 지정한 사용량의 데이터 인덱스입니다.

NotRange.Reserved4

내부 시스템 사용을 위해 예약되어 있습니다.

설명

클라이언트는 HidP_GetValueCaps 또는 HidP_GetSpecificValueCaps 호출하여 값 기능 배열을 가져옵니다. 이러한 루틴은 호출자가 할당한 버퍼에 HIDP_VALUE_CAPS 구조의 배열을 반환합니다. 필요한 버퍼 길이는 HidP_GetCaps 반환된 HIDP_CAPS 구조체에 지정됩니다.

HID 컨트롤 값의 기능에 대한 자세한 내용은 컬렉션 기능 및 값 기능 배열을 참조하세요.