Funzione GetRawInputDeviceInfoA (winuser.h)
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 |
---|---|
|
pData è un puntatore PHIDP_PREPARSED_DATA a un buffer per i dati preparatidi primo livello. |
|
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). |
|
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) |
Vedi anche
Informazioni concettuali
Riferimento
Commenti e suggerimenti
https://aka.ms/ContentUserFeedback.
Presto disponibile: Nel corso del 2024 verranno gradualmente disattivati i problemi di GitHub come meccanismo di feedback per il contenuto e ciò verrà sostituito con un nuovo sistema di feedback. Per altre informazioni, vedereInvia e visualizza il feedback per