Funzione GetRawInputDeviceInfoA (winuser.h)

Articolo
03/08/2023

Recupera informazioni sul dispositivo di input non elaborato.

Sintassi

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

Parametri

[in, optional] hDevice

Tipo: HANDLE

Handle per il dispositivo di input non elaborato. Questo proviene dal membro hDevice di RAWINPUTHEADER o da GetRawInputDeviceList.

[in] uiCommand

Tipo: UINT

Specifica i dati restituiti in pData. Questo parametro può avere uno dei valori seguenti.

Valore	Significato
RIDI_PREPARSEDDATA 0x20000005	pData è un puntatore PHIDP_PREPARSED_DATA a un buffer per i dati preparati di primo livello.
RIDI_DEVICENAME 0x20000007	pData punta a una stringa contenente il nome dell'interfaccia del dispositivo. Se questo dispositivo viene aperto con la modalità di accesso condiviso , è possibile chiamare CreateFile con questo nome per aprire una raccolta HID e usare un handle restituito per chiamare ReadFile per leggere i report di input e WriteFile per inviare report di output. Per altre informazioni, vedere Apertura di raccolte HID e gestione dei report HID. Per questo uiCommand solo, il valore in pcbSize è il conteggio dei caratteri (non il conteggio dei byte).
RIDI_DEVICEINFO 0x2000000b	pData punta a una struttura di RID_DEVICE_INFO .

Valore

Significato

RIDI_PREPARSEDDATA
0x20000005

pData è un puntatore PHIDP_PREPARSED_DATA a un buffer per i dati preparati di primo livello.

RIDI_DEVICENAME
0x20000007

pData punta a una stringa contenente il nome dell'interfaccia del dispositivo.

Se questo dispositivo viene aperto con la modalità di accesso condiviso , è possibile chiamare CreateFile con questo nome per aprire una raccolta HID e usare un handle restituito per chiamare ReadFile per leggere i report di input e WriteFile per inviare report di output.

Per altre informazioni, vedere Apertura di raccolte HID e gestione dei report HID.

Per questo uiCommand solo, il valore in pcbSize è il conteggio dei caratteri (non il conteggio dei byte).

RIDI_DEVICEINFO
0x2000000b

pData punta a una struttura di RID_DEVICE_INFO .

[in, out, optional] pData

Tipo: LPVOID

Puntatore a un buffer contenente le informazioni specificate da uiCommand.

Se uiCommand è RIDI_DEVICEINFO, impostare il membro cbSize di RID_DEVICE_INFO su sizeof(RID_DEVICE_INFO) prima di chiamare GetRawInputDeviceInfo.

[in, out] pcbSize

Tipo: PUINT

Dimensioni, in byte, dei dati in pData.

Valore restituito

Tipo: UINT

In caso di esito positivo, questa funzione restituisce un numero non negativo che indica il numero di byte copiati in pData.

Se pData non è abbastanza grande per i dati, la funzione restituisce -1. Se pData è NULL, la funzione restituisce un valore pari a zero. In entrambi questi casi , pcbSize è impostato sulle dimensioni minime necessarie per il buffer pData .

Chiamare GetLastError per identificare eventuali altri errori.

Commenti

Nota

L'intestazione winuser.h definisce GetRawInputDeviceInfo come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante preprocessore UNICODE. La combinazione dell'utilizzo dell'alias di codifica neutrale con il codice che non è neutrale dalla codifica può causare errori di corrispondenza che causano errori di compilazione o runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzione.

Requisiti

Requisito	Valore
Client minimo supportato	Windows XP [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	winuser.h (include Windows.h)
Libreria	User32.lib
DLL	User32.dll
Set di API	ext-ms-win-ntuser-rawinput-l1-1-0 (introdotta in Windows 10, versione 10.0.14393)