HIDP_VALUE_CAPS 구조체(hidpi.h)

아티클
02/07/2025

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 컨트롤 값의 기능에 대한 자세한 내용은 컬렉션 기능 및 값 기능 배열참조하세요.