KEYBOARD_EXTENDED_ATTRIBUTES-Struktur (ntddkbd.h)
KEYBOARD_EXTENDED_ATTRIBUTES gibt die erweiterten Attribute einer Tastatur an.
Syntax
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;
Member
Version
Typ: UCHAR
Die Version dieser Struktur.
Nur KEYBOARD_EXTENDED_ATTRIBUTES_STRUCT_VERSION_1 unterstützt.
FormFactor
Typ: UCHAR
Tastaturformfaktor (Nutzungs-ID: 0x2C1).
| Wert | BESCHREIBUNG |
|---|---|
| 0x00 | Unbekannter Formfaktor. |
| 0x01 | Full-Size-Tastatur. |
| 0x02 | Kompakte Tastatur. Solche Tastaturen sind weniger als 13 Zoll breit. |
KeyType
Typ: UCHAR
Tastaturtastentyp (Nutzungs-ID: 0x2C2).
| Wert | BESCHREIBUNG |
|---|---|
| 0x00 | Unbekannter Schlüsseltyp. |
| 0x01 | Vollreiseschlüssel. |
| 0x02 | Tasten mit geringem Federweg, z. B. auf Laptoptastaturen. |
| 0x03 | Null-Reise oder virtuelle Schlüssel. |
PhysicalLayout
Typ: UCHAR
Physisches Tastaturlayout (Nutzungs-ID: 0x2C3).
| Wert | BESCHREIBUNG |
|---|---|
| 0x00 | Unbekanntes Layout |
| 0x01 | 101 (z. B. USA) |
| 0x02 | 103 (Korea) |
| 0x03 | 102 (z. B. Deutsch) |
| 0x04 | 104 (z. B. ABNT Brasilien) |
| 0x05 | 106 (DOS/V Japan) |
| 0x06 | Anbieterspezifisch: Falls angegeben, muss auch VendorSpecificPhysicalLayout angegeben werden. |
Dieser Wert bezieht sich nicht auf den Legendensatz, der auf den Tasten gedruckt wird, sondern nur auf das physische Keyset-Layout, das durch die relative Position und Form der Textschlüssel zueinander definiert wird. Dieser Wert gibt an, welche der de facto standard physischen Layouts die Tastatur entspricht. Diese Layouts werden häufig verstanden.
VendorSpecificPhysicalLayout
Typ: UCHAR
Ein numerischer Bezeichner des jeweiligen herstellerspezifischen physischen Tastaturlayouts (Nutzungs-ID: 0x2C4).
Die Werte für dieses Feld werden vom Hardwarehersteller definiert, aber 0x00 wird so definiert, dass kein herstellerspezifisches physisches Tastaturlayout angegeben wird. Wenn ein Wert ungleich Null ist, muss PhysicalLayoutüber einen Wert 0x06 verfügen. Wenn dieser Bezeichner 0x00 ist, darf PhysicalLayout nicht über den Wert 0x06 verfügen.
IETFLanguageTagIndex
Typ: UCHAR
Zeichenfolgenindex eines Zeichenfolgendeskriptors mit einem IETF-Sprachtag (Nutzungs-ID: 0x2C5).
Die tatsächliche Zeichenfolge kann über IOCTL_HID_GET_INDEXED_STRING IOCTL in Kernelmodustreibern abgerufen werden oder HidD_GetIndexedString in Benutzermodusanwendungen aufrufen.
Dieses Sprachtag gibt das beabsichtigte primäre Gebietsschema des Tastaturlegendensatzes an, das IETF BCP 47 oder dessen Nachfolger entspricht.
Wenn kein geeignetes IETF-Sprachtag verfügbar ist, z. B. für benutzerdefinierte, adaptive oder neue Layouts, wird der Wert auf 0x00 festgelegt.
ImplementedInputAssistControls
Typ: UCHAR
Bitmap für physisch implementierte Eingabehilfesteuerelemente. (Nutzungs-ID: 0x2C6).
| bit | BESCHREIBUNG |
|---|---|
| Alle 0 | Es sind keine Steuerelemente für die Tastatureingabehilfe implementiert. |
| Bit 0 | Vorheriger Vorschlag |
| Bit 1 | Nächster Vorschlag |
| Bit 2 | Vorherige Vorschlagsgruppe |
| Bit 3 | Nächste Vorschlagsgruppe |
| Bit 4 | Vorschlag annehmen |
| Bit 5 | Vorschlag abbrechen |
| Alle anderen Bits reserviert. |
Hinweise
Diese Struktur wird mit einer IOCTL_KEYBOARD_QUERY_EXTENDED_ATTRIBUTES-Anforderung verwendet, um Informationen zu den erweiterten Attributen zurückzugeben, die von einer Tastatur unterstützt werden.
Diese Informationen stammen aus dem HID-Tastaturberichtsdeskriptor, der unter HID Usage Table Review Request 42: Consumer Page Keyboard Assist Controls beschrieben wird.
Anforderungen
| Anforderung | Wert |
|---|---|
| Header | ntddkbd.h (include Ntddkbd.h) |
Weitere Informationen
IOCTL_KEYBOARD_QUERY_EXTENDED_ATTRIBUTES