Human Interface Devices (HID)

Übersicht über die HID-Technologie (Human Interface Devices).

Zum Entwickeln von Human Interface Devices (HID) benötigen Sie die folgenden Header:

• hidclass.h
• hidpddi.h
• hidpi.h
• hidport.h
• hidsdi.h
• hidspicx.h
• kbdmou.h
• ntdd8042.h
• vhf.h

Den Programmierleitfaden finden Sie unter Human Interface Devices (HID).

Informationen zu Win32 HID-Programmier-APIs finden Sie unter Win32 Human Interface Devices Reference( Win32 Human Interface Devices Reference).

Dieser Abschnitt enthält die Programmierschnittstellen im Zusammenhang mit Human Interface Devices (hiD). In der Regel handelt es sich dabei um Geräte, mit denen Menschen den Betrieb von Computersystemen direkt steuern.

HIDClass-Supportroutinen

Es gibt vom System bereitgestellte Routinen, die Benutzermodusanwendungen, Kernelmodustreiber und HID-Minitreiber verwenden, um Geräte in der HIDClass-Gerätesetupklasse zu betreiben.

In der Regel können Benutzermodusanwendungen die routinen HidD_Xxx und HidP_Xxx verwenden. Kernelmodustreiber können jedoch nur HidP_Xxx Routinen aufrufen.

HID-Minitreiber verwenden nur die HidRegisterMinidriver-Routine .

Für Windows 8.1 Microsoft die neue Windows.Devices.HumanInterfaceDevice-API eingeführt, mit der Sie Windows-Apps schreiben können, die auf HID-Geräte zugreifen.

Der Header definiert IOCTLs, die ein HID-Minidriver unterstützen muss. Nur der HID-Klassentreiber sendet diese IOCTLs an einen HID-Minitreiber. Benutzermodusanwendungen und andere Kernelmodustreiber können nur mithilfe der HIDClass-Unterstützungsroutinen und DER HID-Klassentreiber-IOCTLs mit HID-Sammlungen kommunizieren.

HID Minidriver-IOCTLs

Ein HID-Minitreiber muss eine Reihe von IOCTLs verarbeiten. Nur der HID-Klassentreiber sendet diese IOCTLs an einen HID-Minitreiber. Benutzermodusanwendungen und andere Kernelmodustreiber können nur mithilfe der HIDClass-Unterstützungsroutinen und DER HID-Klassentreiber-IOCTLs mit HID-Sammlungen kommunizieren.

HID-Klassentreiber-IOCTLs

Der HID-Klassentreiber verarbeitet IOCTLs, um Sammlungen der obersten Ebene zu unterstützen.

Obwohl Benutzeranwendungen mit dem HID-Klassentreiber kommunizieren können, indem HidD_Xxx HIDClass-Unterstützungsroutinen verwendet werden, müssen Kernelmodustreiber die entsprechenden In diesem Abschnitt beschriebenen Gerätesteuerungsanforderungen senden.

Die Eingabe- und Ausgabeparameter sind anforderungsspezifisch.

Nach Abschluss einer Anforderung werden die E/A-status Blockmember wie folgt festgelegt:

Das Status-Element wird vom HID-Klassentreiber für alle Anforderungen festgelegt, die er verarbeitet.

Wie für jede IOCTL beschrieben, wird das Information-Element entweder vom Klassentreiber oder einem Treiber auf niedrigerer Ebene festgelegt. Wenn ein Treiber auf niedrigerer Ebene Daten von oder an ein Gerät überträgt, legt der Treiber auf niedrigerer Ebene Informationen auf die Anzahl der übertragenen Bytes fest. Der HID-Klassentreiber gibt jedoch möglicherweise einen anderen Wert zurück.

Reserviert für die interne Systemnutzung

In diesem Abschnitt werden in alphabetischer Reihenfolge die HIDClass-bezogenen Routinen, Strukturen, Enumerationstypen und Datentypen aufgelistet, die für die interne Systemverwendung reserviert sind.

• DeviceObjectState
• HID_DRIVER_CONFIG
• HID_INTERFACE_HIDPARSE
• HID_INTERFACE_NOTIFY_PNP
• HIDD_CONFIGURATION
• HidD_GetConfiguration
• HidD_GetMsGenreDescriptor
• HidD_SetConfiguration
• HIDP_COLLECTION_DESC
• HIDP_DEVICE_DESC
• HidP_FreeCollectionDescription
• HIDP_GETCOLDESC_DBG
• HIDP_KEYBOARD_DIRECTION
• HIDP_KEYBOARD_MODIFIER_STATE
• HIDP_REPORT_IDS
• HidP_SysPowerCaps
• HidP_SysPowerEvent
• HidP_TranslateUsageAndPagesToI8042ScanCodes
• PHID_STATUS_CHANGE
• PHIDP_INSERT_SCANCODES
• PHIDP_REPORT_DESCRIPTOR

DeviceObjectState

Der DeviceObjectState-Enumerationstyp ist für die interne Systemverwendung reserviert.

enum DeviceObjectState {
  DeviceObjectStarted,
  DeviceObjectStopped,
  DeviceObjectRemoved
};

In Hidclass.h deklarierte Header.

HID_DRIVER_CONFIG

Die HID_DRIVER_CONFIG-Struktur ist für die interne Systemverwendung reserviert.

typedef struct _HID_DRIVER_CONFIG {
  ULONG  Size;
  ULONG  RingBufferSize;
} HID_DRIVER_CONFIG, *PHID_DRIVER_CONFIG;

In Hidclass.h deklarierte Header.

HID_INTERFACE_HIDPARSE

Die HID_INTERFACE_HIDPARSE-Struktur ist für die interne Systemverwendung reserviert.

typedef struct _HID_INTERFACE_HIDPARSE {
#ifndef __cplusplus
  INTERFACE;
#else
  INTERFACE  i;
#endif
  PHIDP_GETCAPS  HidpGetCaps;
} HID_INTERFACE_HIDPARSE, *PHID_INTERFACE_HIDPARSE;

In Hidclass.h deklarierte Header.

HID_INTERFACE_NOTIFY_PNP

Die HID_INTERFACE_NOTIFY_PNP-Struktur ist für die interne Systemverwendung reserviert.

typedef struct _HID_INTERFACE_NOTIFY_PNP {
#ifndef __cplusplus
  INTERFACE;
#else
  INTERFACE  i;
#endif
  PHID_STATUS_CHANGE  StatusChangeFn;
  PVOID CallbackContext;
} HID_INTERFACE_NOTIFY_PNP, *PHID_INTERFACE_NOTIFY_PNP;

In Hidclass.h deklarierte Header.

HIDD_CONFIGURATION

Die HIDD_CONFIGURATION-Struktur ist für die interne Systemverwendung reserviert.

typedef struct _HIDD_CONFIGURATION {
  PVOID  cookie;
  ULONG  size;
  ULONG  RingBufferSize;
} HIDD_CONFIGURATION, *PHIDD_CONFIGURATION;

In Hidsdi.h deklarierte Header.

HidD_GetConfiguration

Die HidD_GetConfiguration Routine ist für die interne Systemnutzung reserviert.

BOOLEAN __stdcall
HidD_GetConfiguration(
    IN HANDLE  HidDeviceObject,
    OUT PHIDD_CONFIGURATION  Configuration,
    IN ULONG  ConfigurationLength
    );

In Hidsdi.h deklarierte Header.

HidD_GetMsGenreDescriptor

Die HidD_GetMsGenreDescriptor Routine ist für die interne Systemnutzung reserviert.

BOOLEAN __stdcall
HidD_GetMsGenreDescriptor(
    IN HANDLE  HidDeviceObject,
    OUT PVOID  Buffer,
    IN ULONG  BufferLength
    );

In Hidsdi.h deklarierte Header.

HidD_SetConfiguration

Die HidD_SetConfiguration Routine ist für die interne Systemnutzung reserviert.

BOOLEAN __stdcall
HidD_SetConfiguration(
    IN HANDLE  HidDeviceObject,
    IN PHIDD_CONFIGURATION  Configuration,
    IN ULONG  ConfigurationLength
    );

In Hidsdi.h deklarierte Header.

HIDP_COLLECTION_DESC

Die HIDP_COLLECTION_DESC-Struktur ist für die interne Systemverwendung reserviert.

typedef struct _HIDP_COLLECTION_DESC {
  USAGE  UsagePage;
  USAGE  Usage;
  UCHAR  CollectionNumber;
  UCHAR  Reserved [15];
  USHORT  InputLength;
  USHORT  OutputLength;
  USHORT  FeatureLength;
  USHORT  PreparsedDataLength;
  PHIDP_PREPARSED_DATA  PreparsedData;
} HIDP_COLLECTION_DESC, *PHIDP_COLLECTION_DESC;

In Hidpddi.h deklarierte Header.

HIDP_DEVICE_DESC

Die HIDP_DEVICE_DESC-Struktur ist für die interne Systemverwendung reserviert.

typedef struct _HIDP_DEVICE_DESC {
  PHIDP_COLLECTION_DESC  CollectionDesc;
  ULONG  CollectionDescLength;
  PHIDP_REPORT_IDS  ReportIDs;
  ULONG  ReportIDsLength;
  HIDP_GETCOLDESC_DBG  Dbg;
} HIDP_DEVICE_DESC, *PHIDP_DEVICE_DESC;

In Hidpddi.h deklarierte Header.

HidP_FreeCollectionDescription

Die HidP_FreeCollectionDescription Routine ist für die interne Systemnutzung reserviert.

VOID
HidP_FreeCollectionDescription(
    IN PHIDP_DEVICE_DESC  DeviceDescription
    );

In Hidpddi.h deklarierte Header.

HIDP_GETCOLDESC_DBG

Die HIDP_GETCOLDESC_DBG-Struktur ist für die interne Systemverwendung reserviert.

typedef struct _HIDP_GETCOLDESC_DBG {
  ULONG  BreakOffset;
  ULONG  ErrorCode;
  ULONG  Args[6];
} HIDP_GETCOLDESC_DBG, *PHIDP_GETCOLDESC_DBG;

In Hidpddi.h deklarierte Header.

HIDP_KEYBOARD_DIRECTION

Der HIDP_KEYBOARD_DIRECTION Enumerationstyp ist für die interne Systemverwendung reserviert.

typedef enum _HIDP_KEYBOARD_DIRECTION {
 HidP_Keyboard_Break,
 HidP_Keyboard_Make
} HIDP_KEYBOARD_DIRECTION;

In Hidpi.h deklarierte Header.

HIDP_KEYBOARD_MODIFIER_STATE

Die HIDP_KEYBOARD_MODIFIER_STATE-Struktur ist für die interne Systemverwendung reserviert.

typedef struct _HIDP_KEYBOARD_MODIFIER_STATE {
  union {
    struct {
      ULONG  LeftControl: 1;
      ULONG  LeftShift: 1;
      ULONG  LeftAlt: 1;
      ULONG  LeftGUI: 1;
      ULONG  RightControl: 1;
      ULONG  RightShift: 1;
      ULONG  RightAlt: 1;
      ULONG  RigthGUI: 1;
      ULONG  CapsLock: 1;
      ULONG  ScollLock: 1;
      ULONG  NumLock: 1;
      ULONG  Reserved: 21;
    };
    ULONG ul;
  };
} HIDP_KEYBOARD_MODIFIER_STATE, *PHIDP_KEYBOARD_MODIFIER_STATE;

In Hidpi.h deklarierte Header.

HIDP_REPORT_IDS

Die HIDP_REPORT_IDS-Struktur ist für die interne Systemverwendung reserviert.

typedef struct _HIDP_REPORT_IDS {
  UCHAR  ReportID;
  UCHAR  CollectionNumber;
  USHORT  InputLength;
  USHORT  OutputLength;
  USHORT  FeatureLength;
} HIDP_REPORT_IDS, *PHIDP_REPORT_IDS;

In Hidpddi.h deklarierte Header.

HidP_SysPowerCaps

Die HidP_SysPowerCaps Routine ist für die interne Systemnutzung reserviert.

NTSTATUS
HidP_SysPowerCaps(
    IN PHIDP_PREPARSED_DATA  Ppd,
    OUT PULONG  OutputBuffer
    );

In Hidpddi.h deklarierte Header.

HidP_SysPowerEvent

Die HidP_SysPowerEvent Routine ist für die interne Systemnutzung reserviert.

NTSTATUS
HidP_SysPowerEvent(
    IN PCHAR  HidPacket,
    IN USHORT  HidPacketLength,
    IN PHIDP_PREPARSED_DATA  Ppd,
    OUT PULONG  OutputBuffer
    );

In Hidpddi.h deklarierte Header.

HidP_TranslateUsageAndPagesToI8042ScanCodes

Die HidP_TranslateUsageAndPagesToI8042ScanCodes Routine ist für die interne Systemnutzung reserviert.

NTSTATUS __stdcall
  HidP_TranslateUsageAndPagesToI8042ScanCodes(
    IN PUSAGE_AND_PAGE  ChangedUsageList,
    IN ULONG  UsageListLength,
    IN HIDP_KEYBOARD_DIRECTION  KeyAction,
    IN OUT PHIDP_KEYBOARD_MODIFIER_STATE  ModifierState,
    IN PHIDP_INSERT_SCANCODES  InsertCodesProcedure,
    IN PVOID  InsertCodesContext
    );

In Hidpi.h deklarierte Header.

PHID_STATUS_CHANGE

Die PHID_STATUS_CHANGE Routine ist für die interne Systemnutzung reserviert.

typedef VOID (*PHID_STATUS_CHANGE)(
    PVOID  Context,
    enum DeviceObjectState State
    );

In Hidclass.h deklarierte Header.

PHIDP_INSERT_SCANCODES

Die PHIDP_INSERT_SCANCODES Routine ist für die interne Systemnutzung reserviert.

typedef BOOLEAN (*PHIDP_INSERT_SCANCODES)(
    IN PVOID  Context,
    IN PCHAR  NewScanCodes,
    IN ULONG  Length
    );

In Hidpi.h deklarierte Header.

PHIDP_REPORT_DESCRIPTOR

Der Datentyp PHIDP_REPORT_DESCRIPTOR ist für die interne Systemverwendung reserviert.

typedef PUCHAR  PHIDP_REPORT_DESCRIPTOR;

In Hidpi.h deklarierte Header.

Rückruffunktionen

E/A-Steuerungscodes

IOCTLs

Enumerationen

Functions

Strukturen