Share via

KEYBOARD_EXTENDED_ATTRIBUTES-Struktur (ntddkbd.h)

  • Artikel

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

IOCTL_KEYBOARD_QUERY_ATTRIBUTES

HID-Verwendungstabelle Überprüfen von Anforderung 42: Steuerelemente für die Tastaturunterstützung für Consumerseiten