KEYBOARD_EXTENDED_ATTRIBUTES 구조체(ntddkbd.h)

아티클
08/25/2023

KEYBOARD_EXTENDED_ATTRIBUTES 키보드의 확장 특성을 지정합니다.

구문

typedef struct _KEYBOARD_EXTENDED_ATTRIBUTES {
  UCHAR Version;
  UCHAR FormFactor;
  UCHAR KeyType;
  UCHAR PhysicalLayout;
  UCHAR VendorSpecificPhysicalLayout;
  UCHAR IETFLanguageTagIndex;
  UCHAR ImplementedInputAssistControls;
} KEYBOARD_EXTENDED_ATTRIBUTES, *PKEYBOARD_EXTENDED_ATTRIBUTES;

멤버

Version

형식: UCHAR

이 구조체의 버전입니다.

지원되는 KEYBOARD_EXTENDED_ATTRIBUTES_STRUCT_VERSION_1.

FormFactor

형식: UCHAR

키보드 폼 팩터(사용 ID: 0x2C1).

값	Description
0x00	알 수 없는 폼 팩터입니다.
0x01	전체 크기 키보드.
0x02	압축 키보드. 이러한 키보드의 너비는 13인치 미만입니다.

KeyType

형식: UCHAR

키보드 키 유형(사용 ID: 0x2C2).

값	Description
0x00	알 수 없는 키 유형입니다.
0x01	전체 여행 키.
0x02	노트북 키보드와 같은 낮은 이동 키.
0x03	제로 여행 또는 가상 키.

PhysicalLayout

형식: UCHAR

키보드 물리적 레이아웃(사용 ID: 0x2C3).

값	Description
0x00	알 수 없는 레이아웃
0x01	101(예: 미국)
0x02	103(한국)
0x03	102(예: 독일어)
0x04	104(예: ABNT 브라질)
0x05	106(DOS/V 일본)
0x06	Vendor-specific – 지정된 경우 VendorSpecificPhysicalLayout 도 지정해야 합니다.

이 값은 키에 인쇄된 범례 집합을 참조하는 것이 아니라 서로 관련된 텍스트 키의 상대 위치 및 모양으로 정의된 실제 키 집합 레이아웃을 참조합니다. 이 값은 키보드가 준수하는 사실상 표준 물리적 레이아웃을 나타냅니다. 이러한 레이아웃은 일반적으로 이해됩니다.

VendorSpecificPhysicalLayout

형식: UCHAR

특정 공급업체별 키보드 물리적 레이아웃의 숫자 식별자입니다(사용 ID: 0x2C4).

이 필드의 값은 하드웨어 공급업체에서 정의하지만 0x00 공급업체별 키보드 물리적 레이아웃을 지정하지 않도록 정의됩니다. 0이 아니면 PhysicalLayout 값이 0x06 있어야 합니다. 이 식별자가 0x00경우 PhysicalLayout 에 0x06 값이 없어야 합니다.

IETFLanguageTagIndex

형식: UCHAR

IETF 언어 태그(사용 ID: 0x2C5)가 있는 문자열 설명자의 문자열 인덱스입니다.

실제 문자열은 커널 모드 드라이버의 IOCTL_HID_GET_INDEXED_STRING IOCTL을 통해 가져오거나 사용자 모드 애플리케이션에서 호출을 HidD_GetIndexedString 수 있습니다.

이 언어 태그는 IETF BCP 47 또는 후속 키에 따라 키보드 범례 집합의 의도된 기본 로캘을 지정합니다.

사용자 지정, 적응형 또는 새 레이아웃과 같이 적절한 IETF 언어 태그를 사용할 수 없는 경우 값은 0x00 설정됩니다.

ImplementedInputAssistControls

형식: UCHAR

물리적으로 구현된 입력 지원 컨트롤에 대한 비트맵입니다. (사용 ID: 0x2C6).

bit	Description
모두 0	키보드 입력 지원 컨트롤이 구현되지 않습니다.
비트 0	이전 제안
비트 1	다음 제안
비트 2	이전 제안 그룹
비트 3	다음 제안 그룹
비트 4	제안 수락
비트 5	제안 취소
	예약된 다른 모든 비트입니다.