Informations de référence sur les appareils d’interface humaine

Article
05/20/2023

Vue d’ensemble de la référence de la technologie HID (Human Interface Devices).

Pour développer des appareils d’interface humaine, vous avez besoin des en-têtes suivants :

Pour obtenir des conseils sur la programmation des pilotes HID, consultez :

IOCTLs


IOCTL_KEYBOARD_QUERY_ATTRIBUTES La requête IOCTL_KEYBOARD_QUERY_ATTRIBUTES retourne des informations sur les attributs du clavier.
IOCTL_KEYBOARD_QUERY_EXTENDED_ATTRIBUTES La requête IOCTL_KEYBOARD_QUERY_EXTENDED_ATTRIBUTES retourne des informations sur les attributs du clavier étendu.
IOCTL_KEYBOARD_QUERY_INDICATOR_TRANSLATION La requête IOCTL_KEYBOARD_QUERY_INDICATOR_TRANSLATION retourne des informations sur le mappage entre les codes d’analyse et les indicateurs de clavier.
IOCTL_KEYBOARD_QUERY_INDICATORS La requête IOCTL_KEYBOARD_QUERY_INDICATORS retourne des informations sur les indicateurs de clavier.
IOCTL_KEYBOARD_QUERY_TYPEMATIC La demande IOCTL_KEYBOARD_QUERY_TYPEMATIC retourne les paramètres de type du clavier.
IOCTL_KEYBOARD_SET_INDICATORS La requête IOCTL_KEYBOARD_SET_INDICATORS définit les indicateurs de clavier.
IOCTL_KEYBOARD_SET_TYPEMATIC La requête IOCTL_KEYBOARD_SET_TYPEMATIC définit les paramètres de type du clavier.
IOCTL_MOUSE_QUERY_ATTRIBUTES La requête IOCTL_MOUSE_QUERY_ATTRIBUTES retourne des informations sur les attributs de la souris.

Fonctions


Acquérir La méthode IDirectInputJoyConfig8::Acquire acquiert le « mode de configuration du joystick ». Une seule application peut être en mode de configuration du joystick à la fois ; Les tentatives suivantes d’autres applications d’acquérir ce mode doivent recevoir l’erreur DIERR_OTHERAPPHASPRIO. Après avoir entré le mode de configuration, l’application peut apporter des modifications aux paramètres de configuration globaux du joystick. L’application doit case activée les paramètres existants avant d’installer les nouveaux au cas où une autre application modifie les paramètres entre-temps.
AddNewHardware La méthode IDirectInputJoyConfig8::AddNewHardware affiche la boîte de dialogue Ajouter un nouveau matériel qui guide l’utilisateur tout au long de l’installation d’un nouveau périphérique d’entrée.
AddRef La méthode IDirectInputEffectDriver::AddRef augmente le nombre de références de l’objet DirectInputEffectDriver de 1. Cette méthode fait partie de l’interface IUnknown héritée par DirectInputEffectDriver.
AddRef La méthode IDirectInputJoyConfig8::AddRef augmente le nombre de références de l’objet DirectInputJoyConfig de 1. Cette méthode fait partie de l’interface IUnknown héritée par DirectInputJoyConfig.
DeleteConfig La méthode IDirectInputJoyConfig8::D eleteConfig supprime les informations de configuration relatives à un joystick.
DeleteType La méthode IDirectInputJoyConfig8::D eleteType supprime les informations relatives à un type de joystick. Utilisez cette méthode avec précaution ; il incombe à l’appelant de s’assurer qu’aucun joystick ne fait référence au type supprimé.
DestroyEffect La méthode IDirectInputEffectDriver::D estroyEffect supprime un effet de l’appareil. Si l’effet est en cours de lecture, le pilote doit l’arrêter avant de le décharger.
DeviceID La méthode IDirectInputEffectDriver::D eviceID envoie au pilote l’identité de l’appareil.
DownloadEffect La méthode IDirectInputEffectDriver::D ownloadEffect envoie un effet à l’appareil.
EnumTypes La méthode IDirectInputJoyConfig8::EnumTypes énumère les types de joysticks actuellement pris en charge par DirectInput.
Caractère d'échappement La méthode IDirectInputEffectDriver::Escape s’échappe vers le pilote. Cette méthode est appelée en réponse à une application appelant les méthodes IDirectInputEffect::Escape ou IDirectInputDevice::Escape.
Getconfig La méthode IDirectInputJoyConfig8::GetConfig obtient des informations sur la configuration d’un joystick.
GetEffectStatus La méthode IDirectInputEffectDriver::GetEffectStatus obtient des informations sur la status d’un effet.
GetForceFeedbackState La méthode IDirectInputEffectDriver::GetForceFeedbackState récupère l’état de la rétroaction de force pour l’appareil.
GetTypeInfo La méthode IDirectInputJoyConfig8::GetTypeInfo obtient des informations sur un type de joystick.
GetUserValues La méthode IDirectInputJoyConfig8::GetUserValues obtient des informations sur les paramètres utilisateur du joystick.
GetVersions La méthode IDirectInputEffectDriver::GetVersions obtient des informations de version sur le matériel et le pilote de retour forcé.
OpenAppStatusKey La méthode IDirectInputJoyConfig8::OpenAppStatusKey ouvre la clé racine de l’application status clés de Registre et obtient un handle de la clé en tant que paramètre de retour.
OpenTypeKey La méthode IDirectInputJoyConfig8::OpenTypeKey ouvre la clé de Registre associée à un type de joystick.
QueryInterface La méthode IDirectInputEffectDriver::QueryInterface détermine si l’objet DirectInputEffectDriver prend en charge une interface COM particulière.
QueryInterface La méthode IDirectInputJoyConfig8::QueryInterface détermine si l’objet DirectInputJoyConfig prend en charge une interface COM particulière.
Version release La méthode IDirectInputEffectDriver::Release réduit de 1 le nombre de références de l’objet DirectInputEffectDriver. Cette méthode fait partie de l’interface IUnknown héritée par DirectInputEffectDriver.
Version release La méthode IDirectInputJoyConfig8::Release diminue le nombre de références de l’objet DirectInputJoyConfig de 1. Cette méthode fait partie de l’interface IUnknown héritée par DirectInputJoyConfig.
SendForceFeedbackCommand La méthode IDirectInputEffectDriver::SendForceFeedbackCommand modifie l’état de la rétroaction de force pour l’appareil.
SendNotify La méthode IDirectInputJoyConfig8::SendNotify avertit les pilotes de périphérique et les applications que des modifications ont été apportées à la configuration de l’appareil.
SetConfig La méthode IDirectInputJoyConfig8::SetConfig crée ou redéfinit les informations de configuration relatives à un joystick.
SetCooperativeLevel La méthode IDirectInputJoyConfig8::SetCooperativeLevel établit le niveau de coopération pour le instance de l’appareil. Les seuls niveaux coopératifs pris en charge pour l’interface IDirectInputJoyConfig8 sont DISCL_EXCLUSIVE et DISCL_BACKGROUND.
SetGain La méthode IDirectInputEffectDriver::SetGain définit le gain global de l’appareil.
SetTypeInfo La méthode IDirectInputJoyConfig8::SetTypeInfo crée un nouveau type de joystick ou redéfinit des informations sur un type de joystick existant.
SetUserValues La méthode IDirectInputJoyConfig8::SetUserValues définit les paramètres utilisateur du joystick.
StartEffect La méthode IDirectInputEffectDriver::StartEffect commence la lecture d’un effet. Si l’effet est déjà en cours de lecture, il est redémarré à partir du début.
StopEffect La méthode IDirectInputEffectDriver::StopEffect arrête la lecture d’un effet.
Non-acquire La méthode IDirectInputJoyConfig8::Unacquire désacquire le « mode de configuration du joystick ».

Interfaces


IDirectInputEffectDriver Ces trois méthodes permettent d’ajouter des interfaces supplémentaires à l’objet DirectInputEffectDriver sans affecter les fonctionnalités de l’interface d’origine.
IDirectInputJoyConfig8 L’interface IDirectInputJoyConfig8 contient des méthodes qui permettent aux développeurs matériels qui écrivent des feuilles de propriétés d’écrire et de lire des informations dans et à partir du Registre.

Structures


DIDEVICESTATE La structure DIDEVICESTATE retourne des informations sur l’état d’un appareil de rétroaction de force.
DIDRIVERVERSIONS La structure DIDRIVERVERSIONS est utilisée par le pilote d’effet DirectInput pour renvoyer les informations de version à DirectInput.
DIEFFECTATTRIBUTES La structure DIEFFECTATTRIBUTES décrit les informations contenues dans la valeur « Attributes » de la clé de Registre pour chaque effet pris en charge par un appareil de retour de force.
DIEFFESCAPE La structure DIEFFESCAPE transmet des données spécifiques au matériel directement au pilote de périphérique.
DIFFDEVICEATTRIBUTES La structure DIFFDEVICEATTRIBUTES décrit les informations contenues dans la valeur « Attributes » de la clé de Registre OEMForceFeedback.
DIFFOBJECTATTRIBUTES La structure DIFFOBJECTATTRIBUTES décrit les informations contenues dans la valeur « FFAttributes » de la clé de Registre pour chaque « objet » sur un appareil de retour de force.
DIHIDFFINITINFO La structure DIHIDFFINITINFO est utilisée par DirectInput pour fournir des informations à un pilote hid force-feedback sur l’appareil qu’il est invité à contrôler.
DIJOYCONFIG La structure DIJOYCONFIG contient des informations sur la configuration d’un joystick.
DIJOYTYPEINFO La structure DIJOYTYPEINFO contient des informations sur un type de joystick.
DIJOYUSERVALUES La structure DIJOYUSERVALUES contient des informations sur les paramètres du joystick de l’utilisateur.
DIOBJECTATTRIBUTES La structure DIOBJECTATTRIBUTES décrit les informations contenues dans la valeur « Attributes » de la clé de Registre pour chaque « objet » sur un appareil. Si la valeur « Attributes » est absente, les attributs par défaut sont utilisés.
DIOBJECTCALIBRATION La structure DIOBJECTCALIBRATION décrit les informations contenues dans la valeur « Étalonnage » de la clé de Registre pour chaque axe sur un appareil.
JOYREGHWVALUES La structure JOYREGHWVALUES (mmddk.h) contient la plage de valeurs retournées par le matériel (renseignée par étalonnage).
JOYREGHWVALUES La structure JOYREGHWVALUES (dinputd.h) contient la plage de valeurs retournées par le matériel (renseignée par étalonnage).
KEYBOARD_ATTRIBUTES KEYBOARD_ATTRIBUTES spécifie les attributs d’un clavier.
KEYBOARD_EXTENDED_ATTRIBUTES KEYBOARD_EXTENDED_ATTRIBUTES spécifie les attributs étendus d’un clavier.
KEYBOARD_INDICATOR_PARAMETERS KEYBOARD_INDICATOR_PARAMETERS spécifie l’état des VOYANTS d’un clavier.
KEYBOARD_INDICATOR_TRANSLATION KEYBOARD_INDICATOR_TRANSLATION spécifie un tableau de longueur variable spécifique à l’appareil de mappages entre les codes d’analyse du clavier et les indicateurs LED.
KEYBOARD_INPUT_DATA KEYBOARD_INPUT_DATA contient un paquet de données d’entrée du clavier.
KEYBOARD_TYPEMATIC_PARAMETERS KEYBOARD_TYPEMATIC_PARAMETERS spécifie les paramètres de type d’un clavier.
KEYBOARD_UNIT_ID_PARAMETER KEYBOARD_UNIT_ID_PARAMETER spécifie l’ID d’unité que Kbdclass attribue à un clavier.
MOUSE_ATTRIBUTES MOUSE_ATTRIBUTES spécifie les attributs d’un appareil de souris.
MOUSE_INPUT_DATA MOUSE_INPUT_DATA contient un paquet de données d’entrée de souris.
MOUSE_UNIT_ID_PARAMETER MOUSE_UNIT_ID_PARAMETER spécifie un ID d’unité que Mouclass affecte à une souris.