Funzione GetRawInputDeviceInfoW (winuser.h)

Articolo
07/16/2024

Recupera informazioni sul dispositivo di input non elaborato.

Sintassi

UINT GetRawInputDeviceInfoW(
  [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 che 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)