Referência de dispositivos de interface humana

Artigo
03/09/2023

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

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

Para obter diretrizes de programação de drivers HID, consulte:

IOCTLs


IOCTL_KEYBOARD_QUERY_ATTRIBUTES A solicitação IOCTL_KEYBOARD_QUERY_ATTRIBUTES retorna informações sobre os atributos de teclado.
IOCTL_KEYBOARD_QUERY_EXTENDED_ATTRIBUTES A solicitação IOCTL_KEYBOARD_QUERY_EXTENDED_ATTRIBUTES retorna informações sobre os atributos de teclado estendidos.
IOCTL_KEYBOARD_QUERY_INDICATOR_TRANSLATION A solicitação IOCTL_KEYBOARD_QUERY_INDICATOR_TRANSLATION retorna informações sobre o mapeamento entre códigos de verificação e indicadores de teclado.
IOCTL_KEYBOARD_QUERY_INDICATORS A solicitação IOCTL_KEYBOARD_QUERY_INDICATORS retorna informações sobre os indicadores de teclado.
IOCTL_KEYBOARD_QUERY_TYPEMATIC A solicitação IOCTL_KEYBOARD_QUERY_TYPEMATIC retorna as configurações tipáticas do teclado.
IOCTL_KEYBOARD_SET_INDICATORS A solicitação IOCTL_KEYBOARD_SET_INDICATORS define os indicadores de teclado.
IOCTL_KEYBOARD_SET_TYPEMATIC A solicitação IOCTL_KEYBOARD_SET_TYPEMATIC define as configurações tipáticas do teclado.
IOCTL_MOUSE_QUERY_ATTRIBUTES A solicitação IOCTL_MOUSE_QUERY_ATTRIBUTES retorna informações sobre os atributos do mouse.

Funções


Adquirir O método IDirectInputJoyConfig8::Acquire adquire o "modo de configuração do joystick". Somente um aplicativo pode estar no modo de configuração do joystick por vez; as tentativas subsequentes de outros aplicativos de adquirir esse modo devem receber o erro DIERR_OTHERAPPHASPRIO. Depois de entrar no modo de configuração, o aplicativo pode fazer alterações nas definições de configuração do joystick global. O aplicativo deve marcar as configurações existentes antes de instalar as novas caso outro aplicativo altere as configurações nesse ínterim.
AddNewHardware O método IDirectInputJoyConfig8::AddNewHardware exibe a caixa de diálogo Adicionar Novo Hardware que orienta o usuário na instalação de um novo dispositivo de entrada.
AddRef O método IDirectInputEffectDriver::AddRef aumenta a contagem de referência do objeto DirectInputEffectDriver em 1. Esse método faz parte da interface IUnknown herdada por DirectInputEffectDriver.
AddRef O método IDirectInputJoyConfig8::AddRef aumenta a contagem de referência do objeto DirectInputJoyConfig em 1. Esse método faz parte da interface IUnknown herdada por DirectInputJoyConfig.
DeleteConfig O método IDirectInputJoyConfig8::D eleteConfig exclui informações de configuração sobre um joystick.
DeleteType O método IDirectInputJoyConfig8::D eleteType remove informações sobre um tipo de joystick. Use este método com cuidado; é responsabilidade do chamador garantir que nenhum joystick se refira ao tipo excluído.
DestroyEffect O método IDirectInputEffectDriver::D estroyEffect remove um efeito do dispositivo. Se o efeito estiver sendo reproduzido, o driver deverá interrompê-lo antes de descarregá-lo.
Deviceid O método IDirectInputEffectDriver::D eviceID envia ao driver a identidade do dispositivo.
DownloadEffect O método IDirectInputEffectDriver::D ownloadEffect envia um efeito para o dispositivo.
EnumTypes O método IDirectInputJoyConfig8::EnumTypes enumera os tipos de joystick atualmente compatíveis com o DirectInput.
Escape O método IDirectInputEffectDriver::Escape escapa para o driver. Esse método é chamado em resposta a um aplicativo que invoca os métodos IDirectInputEffect::Escape ou IDirectInputDevice::Escape.
GetConfig O método IDirectInputJoyConfig8::GetConfig obtém informações sobre a configuração de um joystick.
GetEffectStatus O método IDirectInputEffectDriver::GetEffectStatus obtém informações sobre o status de um efeito.
GetForceFeedbackState O método IDirectInputEffectDriver::GetForceFeedbackState recupera o estado force-feedback para o dispositivo.
Gettypeinfo O método IDirectInputJoyConfig8::GetTypeInfo obtém informações sobre um tipo de joystick.
GetUserValues O método IDirectInputJoyConfig8::GetUserValues obtém informações sobre as configurações do usuário para o joystick.
GetVersions O método IDirectInputEffectDriver::GetVersions obtém informações de versão sobre o hardware e o driver de force-feedback.
OpenAppStatusKey O método IDirectInputJoyConfig8::OpenAppStatusKey abre a chave raiz do aplicativo status chaves do Registro e obtém um identificador para a chave como um parâmetro de retorno.
OpenTypeKey O método IDirectInputJoyConfig8::OpenTypeKey abre a chave do Registro associada a um tipo de joystick.
QueryInterface O método IDirectInputEffectDriver::QueryInterface determina se o objeto DirectInputEffectDriver dá suporte a uma interface COM específica.
QueryInterface O método IDirectInputJoyConfig8::QueryInterface determina se o objeto DirectInputJoyConfig dá suporte a uma interface COM específica.
Versão O método IDirectInputEffectDriver::Release diminui a contagem de referência do objeto DirectInputEffectDriver em 1. Esse método faz parte da interface IUnknown herdada por DirectInputEffectDriver.
Versão O método IDirectInputJoyConfig8::Release diminui a contagem de referência do objeto DirectInputJoyConfig em 1. Esse método faz parte da interface IUnknown herdada por DirectInputJoyConfig.
SendForceFeedbackCommand O método IDirectInputEffectDriver::SendForceFeedbackCommand altera o estado force-feedback para o dispositivo.
SendNotify O método IDirectInputJoyConfig8::SendNotify notifica os drivers de dispositivo e os aplicativos de que foram feitas alterações na configuração do dispositivo.
SetConfig O método IDirectInputJoyConfig8::SetConfig cria ou redefine informações de configuração sobre um joystick.
Setcooperativelevel O método IDirectInputJoyConfig8::SetCooperativeLevel estabelece o nível de cooperação para a instância do dispositivo. Os únicos níveis cooperativos com suporte para a interface IDirectInputJoyConfig8 são DISCL_EXCLUSIVE e DISCL_BACKGROUND.
SetGain O método IDirectInputEffectDriver::SetGain define o ganho geral do dispositivo.
SetTypeInfo O método IDirectInputJoyConfig8::SetTypeInfo cria um novo tipo de joystick ou redefine informações sobre um tipo de joystick existente.
SetUserValues O método IDirectInputJoyConfig8::SetUserValues define as configurações do usuário para o joystick.
StartEffect O método IDirectInputEffectDriver::StartEffect inicia a reprodução de um efeito. Se o efeito já estiver sendo reproduzido, ele será reiniciado desde o início.
StopEffect O método IDirectInputEffectDriver::StopEffect interrompe a reprodução de um efeito.
Não requisito O método IDirectInputJoyConfig8::Unacquire cancela o "modo de configuração do joystick".

Interfaces


IDirectInputEffectDriver Esses três métodos permitem que interfaces adicionais sejam adicionadas ao objeto DirectInputEffectDriver sem afetar a funcionalidade da interface original.
IDirectInputJoyConfig8 A interface IDirectInputJoyConfig8 contém métodos que permitem aos desenvolvedores de hardware que estão escrevendo folhas de propriedades gravar e ler informações de e para o Registro.

Estruturas


DIDEVICESTATE A estrutura DIDEVICESTATE retorna informações sobre o estado de um dispositivo de comentários forçados.
DIDRIVERVERSIONS A estrutura DIDRIVERVERSIONS é usada pelo driver de efeito DirectInput para relatar informações de versão de volta ao DirectInput.
DIEFFECTATTRIBUTES A estrutura DIEFFECTATTRIBUTES descreve as informações contidas no valor "Atributos" da chave do Registro para cada efeito compatível com um dispositivo de comentários forçados.
DIEFFESCAPE A estrutura DIEFFESCAPE passa dados específicos do hardware diretamente para o driver do dispositivo.
DIFFDEVICEATTRIBUTES A estrutura DIFFDEVICEATTRIBUTES descreve as informações contidas no valor "Atributos" da chave do registro OEMForceFeedback.
DIFFOBJECTATTRIBUTES A estrutura DIFFOBJECTATTRIBUTES descreve as informações contidas no valor "FFAttributes" da chave do Registro para cada "objeto" em um dispositivo de comentários forçados.
DIHIDFFINITINFO A estrutura DIHIDFFINITINFO é usada pelo DirectInput para fornecer informações a um driver de comentários forçados hid sobre o dispositivo que está sendo solicitado a controlar.
DIJOYCONFIG A estrutura DIJOYCONFIG contém informações sobre a configuração de um joystick.
DIJOYTYPEINFO A estrutura DIJOYTYPEINFO contém informações sobre um tipo de joystick.
DIJOYUSERVALUES A estrutura DIJOYUSERVALUES contém informações sobre as configurações do joystick do usuário.
DIOBJECTATTRIBUTES A estrutura DIOBJECTATTRIBUTES descreve as informações contidas no valor "Atributos" da chave do Registro para cada "objeto" em um dispositivo. Se o valor "Atributos" estiver ausente, os atributos padrão serão usados.
DIOBJECTCALIBRATION A estrutura DIOBJECTCALIBRATION descreve as informações contidas no valor "Calibração" da chave do Registro para cada eixo em um dispositivo.
JOYREGHWVALUES A estrutura JOYREGHWVALUES (mmddk.h) contém o intervalo de valores retornados pelo hardware (preenchido pela calibragem).
JOYREGHWVALUES A estrutura JOYREGHWVALUES (dinputd.h) contém o intervalo de valores retornados pelo hardware (preenchido pela calibragem).
KEYBOARD_ATTRIBUTES KEYBOARD_ATTRIBUTES especifica os atributos de um teclado.
KEYBOARD_EXTENDED_ATTRIBUTES KEYBOARD_EXTENDED_ATTRIBUTES especifica os atributos estendidos de um teclado.
KEYBOARD_INDICATOR_PARAMETERS KEYBOARD_INDICATOR_PARAMETERS especifica o estado dos LEDs indicadores de um teclado.
KEYBOARD_INDICATOR_TRANSLATION KEYBOARD_INDICATOR_TRANSLATION especifica uma matriz de mapeamentos de comprimento variável específica do dispositivo entre códigos de verificação de teclado e indicadores DE LED.
KEYBOARD_INPUT_DATA KEYBOARD_INPUT_DATA contém um pacote de dados de entrada de teclado.
KEYBOARD_TYPEMATIC_PARAMETERS KEYBOARD_TYPEMATIC_PARAMETERS especifica as configurações tipáticas de um teclado.
KEYBOARD_UNIT_ID_PARAMETER KEYBOARD_UNIT_ID_PARAMETER especifica a ID de unidade que o Kbdclass atribui a um teclado.
MOUSE_ATTRIBUTES MOUSE_ATTRIBUTES especifica os atributos de um dispositivo do mouse.
MOUSE_INPUT_DATA MOUSE_INPUT_DATA contém um pacote de dados de entrada do mouse.
MOUSE_UNIT_ID_PARAMETER MOUSE_UNIT_ID_PARAMETER especifica uma ID de unidade que mouclass atribui a um mouse.