Funzione GetRawInputDeviceInfoA (winuser.h)

Articolo
11/20/2024

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 deriva dal membro hDevice di RAWINPUTHEADER o da GetRawInputDeviceList.

[in] uiCommand

Tipo: UINT

Specifica quali dati verranno restituiti in pData. Questo parametro può essere uno dei valori seguenti.

Valore	Significato
RIDI_PREPARSEDDATA 0x20000005	pData è un puntatore PHIDP_PREPARSED_DATA a un buffer per un di raccolta di livello superiore.
RIDI_DEVICENAME 0x20000007	pData punta a una stringa contenente il nome dell'interfaccia del dispositivo . Se questo dispositivo è aperto con modalità di accesso condiviso, è possibile chiamare CreateFile con questo nome per aprire una raccolta HID e usare l'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. Solo per questo uiCommand, il valore in pcbSize è il conteggio dei caratteri (non il conteggio dei byte).
RIDI_DEVICEINFO 0x2000000b	pData punta a una struttura RID_DEVICE_INFO.

Valore

Significato

RIDI_PREPARSEDDATA
0x20000005

pData è un puntatore PHIDP_PREPARSED_DATA a un buffer per un di raccolta di livello superiore.

RIDI_DEVICENAME
0x20000007

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

Se questo dispositivo è aperto con modalità di accesso condiviso, è possibile chiamare CreateFile con questo nome per aprire una raccolta HID e usare l'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.

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

RIDI_DEVICEINFO
0x2000000b

pData punta a una struttura 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 prima di chiamare GetRawInputDeviceInfo.

[in, out] pcbSize

Tipo: PUINT

Dimensioni, in byte, dei dati in pData.

Valore restituito

Tipo: UINT

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

Se pData non è sufficientemente 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 sulla dimensione minima necessaria per il buffer pData .

Chiamare GetLastError per identificare eventuali altri errori.

Osservazioni

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 del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows XP [solo app desktop]
server minimo supportato	Windows Server 2003 [solo app desktop]
piattaforma di destinazione	Finestre
intestazione	winuser.h (include Windows.h)
libreria	User32.lib
dll	User32.dll
set di API	ext-ms-win-ntuser-rawinput-l1-1-0 (introdotto in Windows 10, versione 10.0.14393)