KEYBOARD_EXTENDED_ATTRIBUTES結構 (ntddkbd.h)

發行項
02/29/2024

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

鍵盤尺寸 (使用量標識碼： 0x2C1) 。

值	Description
0x00	未知的 Form Factor。
0x01	完整/大小鍵盤。
0x02	精簡鍵盤。這類鍵盤小於 13 英吋寬。

KeyType

類型： UCHAR

鍵盤按鍵類型 (使用方式標識碼： 0x2C2) 。

值	Description
0x00	未知的索引鍵類型。
0x01	完整移動金鑰。
0x02	低移動鍵，例如膝上型計算機鍵盤上的按鍵。
0x03	零/移動或虛擬金鑰。

PhysicalLayout

類型： UCHAR

鍵盤實體版面配置 (使用標識碼： 0x2C3) 。

值	Description
0x00	未知的配置
0x01	101 (，例如美國)
0x02	103 (韓)
0x03	102 (，例如德文)
0x04	104 (例如ABNT巴西)
0x05	106 (DOS/V 日本)
0x06	Vendor？specific – 如果指定，也必須指定 VendorSpecificPhysicalLayout 。

這個值不會參照列印在索引鍵上的圖例集，而是只參考實體索引鍵集配置，由文字索引鍵的相對位置和圖形所定義，彼此相對。這個值表示鍵盤符合的事實上標準實體版面配置。通常會了解這些版面配置。

VendorSpecificPhysicalLayout

類型： UCHAR

特定廠商特定鍵盤實體版面配置 (使用標識碼的數值標識碼： 0x2C4) 。

此欄位的值是由硬體廠商所定義，但0x00定義為未指定廠商特定的鍵盤實體配置。如果為非零， PhysicalLayout 必須具有值 0x06。如果此標識碼0x00，PhysicalLayout 不得具有值0x06。

IETFLanguageTagIndex

類型： UCHAR

字串描述元的字串索引，其具有IETF語言標籤 (使用識別碼：0x2C5) 。

實際字串可以透過核心模式驅動程式中的 IOCTL IOCTL_HID_GET_INDEXED_STRING IOCTL取得，或在使用者模式應用程式中 HidD_GetIndexedString 呼叫。

此語言標籤會指定鍵盤圖例集的預定主要地區設定，符合 IETF BCP 47 或其後續專案。

如果無法使用適當的 IETF 語言標籤，例如自訂、調適型或新的版面配置，此值會設定為 0x00。

ImplementedInputAssistControls

類型： UCHAR

實際實作輸入輔助控件的點陣圖。 (使用量標識碼： 0x2C6) 。

bit	描述
全部 0	不會實作鍵盤輸入輔助控制件。
位0	先前的建議
位1	下一個建議
位2	先前的建議群組
位3	下一個建議群組
位 4	接受建議
位5	取消建議
	保留所有其他位。