HID (Dispositivos de Interface Humana)

Visão geral da tecnologia HID (Dispositivos de Interface Humana).

Para desenvolver dispositivos de interface humana (HID), você precisa destes cabeçalhos:

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

Para obter o guia de programação, consulte DISPOSITIVOs de interface humana (HID).

Para APIs de programação HID do Win32, consulte Referência de dispositivos de interface humana Win32.

Esta seção contém as interfaces de programação relacionadas a Dispositivos de Interface Humana (ou HID). Normalmente, esses são dispositivos que os humanos usam para controlar diretamente a operação de sistemas de computador.

Rotinas de suporte hidclass

Há rotinas fornecidas pelo sistema que aplicativos de modo de usuário, drivers de modo kernel e minidrivers HID usam para operar dispositivos na classe de configuração de dispositivo HIDClass.

Como regra geral, os aplicativos de modo de usuário podem usar as rotinas HidD_Xxx e HidP_Xxx. No entanto, os drivers no modo kernel só podem chamar rotinas de HidP_Xxx.

Os minidrivers HID usam apenas a rotina HidRegisterMinidriver .

Para Windows 8.1 a Microsoft introduziu a nova API Windows.Devices.HumanInterfaceDevice, que permite que você escreva aplicativos do Windows que acessam dispositivos HID.

O cabeçalho define IOCTLs aos quais um minidriver HID deve dar suporte. Somente o driver de classe HID envia essas IOCTLs para um minidriver HID. Aplicativos de modo de usuário e outros drivers de modo kernel só podem se comunicar com coleções HID usando as rotinas de suporte HIDClass e IOCTLs do driver de classe HID.

HID Minidriver IOCTLs

Um minidriver HID deve manipular um conjunto de IOCTLs. Somente o driver de classe HID envia essas IOCTLs para um minidriver HID. Aplicativos de modo de usuário e outros drivers de modo kernel só podem se comunicar com coleções HID usando as rotinas de suporte HIDClass e IOCTLs do driver de classe HID.

IOCTLs do Driver de Classe HID

O driver de classe HID manipula IOCTLs para dar suporte a coleções de nível superior.

Embora os aplicativos de usuário possam se comunicar com o driver de classe HID usando HidD_Xxx rotinas de suporte HIDClass, os drivers de modo kernel devem enviar as solicitações de controle de dispositivo correspondentes descritas nesta seção.

Os parâmetros de entrada e saída são específicos da solicitação.

Após a conclusão de uma solicitação, os membros do bloco de status de E/S são definidos da seguinte maneira:

O membro Status é definido pelo driver de classe HID para todas as solicitações que ele manipula.

Conforme descrito para cada IOCTL, o membro Information é definido pelo driver de classe ou por um driver de nível inferior. Normalmente, quando um driver de nível inferior transfere dados de ou para um dispositivo, o driver de nível inferior define Informações como o número de bytes transferidos. No entanto, o driver de classe HID pode retornar um valor diferente.

Reservado para uso interno do sistema

Esta seção lista, em ordem alfabética, as rotinas, estruturas, tipos de enumeração e tipos de dados relacionados a HIDClass que são reservados para uso interno do sistema.

• 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

O tipo de enumeração DeviceObjectState é reservado para uso interno do sistema.

enum DeviceObjectState {
  DeviceObjectStarted,
  DeviceObjectStopped,
  DeviceObjectRemoved
};

Cabeçalhos declarados em Hidclass.h.

HID_DRIVER_CONFIG

A estrutura HID_DRIVER_CONFIG é reservada para uso interno do sistema.

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

Cabeçalhos declarados em Hidclass.h.

HID_INTERFACE_HIDPARSE

A estrutura HID_INTERFACE_HIDPARSE é reservada para uso interno do sistema.

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

Cabeçalhos declarados em Hidclass.h.

HID_INTERFACE_NOTIFY_PNP

A estrutura HID_INTERFACE_NOTIFY_PNP é reservada para uso interno do sistema.

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;

Cabeçalhos declarados em Hidclass.h.

HIDD_CONFIGURATION

A estrutura de HIDD_CONFIGURATION é reservada para uso interno do sistema.

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

Cabeçalhos declarados em Hidsdi.h.

HidD_GetConfiguration

A rotina HidD_GetConfiguration é reservada para uso interno do sistema.

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

Cabeçalhos declarados em Hidsdi.h.

HidD_GetMsGenreDescriptor

A rotina HidD_GetMsGenreDescriptor é reservada para uso interno do sistema.

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

Cabeçalhos declarados em Hidsdi.h.

HidD_SetConfiguration

A rotina HidD_SetConfiguration é reservada para uso interno do sistema.

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

Cabeçalhos declarados em Hidsdi.h.

HIDP_COLLECTION_DESC

A estrutura HIDP_COLLECTION_DESC é reservada para uso interno do sistema.

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;

Cabeçalhos declarados em Hidpddi.h.

HIDP_DEVICE_DESC

A estrutura de HIDP_DEVICE_DESC é reservada para uso interno do sistema.

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;

Cabeçalhos declarados em Hidpddi.h.

HidP_FreeCollectionDescription

A rotina de HidP_FreeCollectionDescription é reservada para uso interno do sistema.

VOID
HidP_FreeCollectionDescription(
    IN PHIDP_DEVICE_DESC  DeviceDescription
    );

Cabeçalhos declarados em Hidpddi.h.

HIDP_GETCOLDESC_DBG

A estrutura de HIDP_GETCOLDESC_DBG é reservada para uso interno do sistema.

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

Cabeçalhos declarados em Hidpddi.h.

HIDP_KEYBOARD_DIRECTION

O tipo de enumeração HIDP_KEYBOARD_DIRECTION é reservado para uso interno do sistema.

typedef enum _HIDP_KEYBOARD_DIRECTION {
 HidP_Keyboard_Break,
 HidP_Keyboard_Make
} HIDP_KEYBOARD_DIRECTION;

Cabeçalhos declarados em Hidpi.h.

HIDP_KEYBOARD_MODIFIER_STATE

A estrutura de HIDP_KEYBOARD_MODIFIER_STATE é reservada para uso interno do sistema.

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;

Cabeçalhos declarados em Hidpi.h.

HIDP_REPORT_IDS

A estrutura HIDP_REPORT_IDS é reservada para uso interno do sistema.

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

Cabeçalhos declarados em Hidpddi.h.

HidP_SysPowerCaps

A rotina HidP_SysPowerCaps é reservada para uso interno do sistema.

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

Cabeçalhos declarados em Hidpddi.h.

HidP_SysPowerEvent

A rotina de HidP_SysPowerEvent é reservada para uso interno do sistema.

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

Cabeçalhos declarados em Hidpddi.h.

HidP_TranslateUsageAndPagesToI8042ScanCodes

A rotina HidP_TranslateUsageAndPagesToI8042ScanCodes é reservada para uso interno do sistema.

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
    );

Cabeçalhos declarados em Hidpi.h.

PHID_STATUS_CHANGE

A rotina de PHID_STATUS_CHANGE é reservada para uso interno do sistema.

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

Cabeçalhos declarados em Hidclass.h.

PHIDP_INSERT_SCANCODES

A rotina de PHIDP_INSERT_SCANCODES é reservada para uso interno do sistema.

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

Cabeçalhos declarados em Hidpi.h.

PHIDP_REPORT_DESCRIPTOR

O tipo de dados PHIDP_REPORT_DESCRIPTOR é reservado para uso interno do sistema.

typedef PUCHAR  PHIDP_REPORT_DESCRIPTOR;

Cabeçalhos declarados em Hidpi.h.

Funções de retorno de chamada

Códigos de controle de E/S

IOCTLs

Enumerações

Funções

Estruturas