GetRawInputDeviceInfoA, fonction (winuser.h)

Article
07/16/2024

Récupère des informations sur l’appareil d’entrée brute.

Syntaxe

UINT GetRawInputDeviceInfoA(
  [in, optional]      HANDLE hDevice,
  [in]                UINT   uiCommand,
  [in, out, optional] LPVOID pData,
  [in, out]           PUINT  pcbSize
);

Paramètres

[in, optional] hDevice

Type : HANDLE

Handle vers l’appareil d’entrée brut. Cela provient du membre hDevice de RAWINPUTHEADER ou de GetRawInputDeviceList.

[in] uiCommand

Type : uiNT

Spécifie les données retournées dans pData . Ce paramètre peut être l’une des valeurs suivantes.

Valeur	Signification
RIDI_PREPARSEDDATA 0x20000005	pData est un pointeur PHIDP_PREPARSED_DATA vers une mémoire tampon pour une collection de niveau supérieur de données prédéfinies.
RIDI_DEVICENAME 0x20000007	pData pointe vers une chaîne qui contient le nom de l’interface de l’appareil . Si cet appareil est ouvert avec le mode d’accès partagé, vous pouvez appeler CreateFile avec ce nom pour ouvrir une collection HID et utiliser le handle retourné pour appeler ReadFile pour lire les rapports d’entrée et WriteFile pour envoyer des rapports de sortie. Pour plus d’informations, consultez Ouverture de collections HID et gestion des rapports HID. Pour cette uiCommand uniquement, la valeur de est le nombre de caractères (et non le nombre d’octets).
RIDI_DEVICEINFO 0x2000000b	pData pointe vers une structure RID_DEVICE_INFO.

Valeur

Signification

RIDI_PREPARSEDDATA
0x20000005

pData est un pointeur PHIDP_PREPARSED_DATA vers une mémoire tampon pour une collection de niveau supérieur de données prédéfinies.

RIDI_DEVICENAME
0x20000007

pData pointe vers une chaîne qui contient le nom de l’interface de l’appareil .

Si cet appareil est ouvert avec le mode d’accès partagé, vous pouvez appeler CreateFile avec ce nom pour ouvrir une collection HID et utiliser le handle retourné pour appeler ReadFile pour lire les rapports d’entrée et WriteFile pour envoyer des rapports de sortie.

Pour plus d’informations, consultez Ouverture de collections HID et gestion des rapports HID.

Pour cette uiCommand uniquement, la valeur de est le nombre de caractères (et non le nombre d’octets).

RIDI_DEVICEINFO
0x2000000b

pData pointe vers une structure RID_DEVICE_INFO.

[in, out, optional] pData

Type : LPVOID

Pointeur vers une mémoire tampon qui contient les informations spécifiées par uiCommand.

Si uiCommand est RIDI_DEVICEINFO, définissez le membre cbSize de RID_DEVICE_INFO sur sizeof(RID_DEVICE_INFO) avant d’appeler GetRawInputDeviceInfo.

[in, out] pcbSize

Type : PUINT

Taille, en octets, des données dans pData .

Valeur de retour

Type : uiNT

Si elle réussit, cette fonction renvoie un nombre non négatif indiquant le nombre d’octets copiés dans pData.

Si pData n’est pas suffisamment volumineux pour les données, la fonction retourne -1. Si pData est NULL, la fonction retourne la valeur zéro. Dans ces deux cas, configure à la taille minimale requise pour la mémoire tampon pData .

Appelez GetLastError pour identifier les autres erreurs.

Remarques

Note

L’en-tête winuser.h définit GetRawInputDeviceInfo comme alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. Le mélange de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.

Exigences

Exigence	Valeur
client minimum pris en charge	Windows XP [applications de bureau uniquement]
serveur minimum pris en charge	Windows Server 2003 [applications de bureau uniquement]
plateforme cible	Windows
d’en-tête	winuser.h (include Windows.h)
bibliothèque	User32.lib
DLL	User32.dll
ensemble d’API	ext-ms-win-ntuser-rawinput-l1-1-0 (introduit dans Windows 10, version 10.0.14393)