Funzione RegisterRawInputDevices (winuser.h)
Registra i dispositivi che forniscono i dati di input non elaborati.
Sintassi
BOOL RegisterRawInputDevices(
[in] PCRAWINPUTDEVICE pRawInputDevices,
[in] UINT uiNumDevices,
[in] UINT cbSize
);
Parametri
[in] pRawInputDevices
Tipo: PCRAWINPUTDEVICE
Matrice di strutture RAWINPUTDEVICE che rappresentano i dispositivi che forniscono l'input non elaborato.
[in] uiNumDevices
Tipo: UINT
Numero di strutture RAWINPUTDEVICE a cui fa riferimento pRawInputDevices.
[in] cbSize
Tipo: UINT
Dimensioni, in byte, di una struttura RAWINPUTDEVICE .
Valore restituito
Tipo: BOOL
TRUE se la funzione ha esito positivo; in caso contrario, FALSE. Se la funzione ha esito negativo, chiamare GetLastError per altre informazioni.
Commenti
Per ricevere WM_INPUT messaggi, un'applicazione deve prima registrare i dispositivi di input non elaborati usando RegisterRawInputDevices. Per impostazione predefinita, un'applicazione non riceve input non elaborato.
Per ricevere WM_INPUT_DEVICE_CHANGE messaggi, un'applicazione deve specificare il flag di RIDEV_DEVNOTIFY per ogni classe di dispositivo specificata dai campi usUsagePage e usUsage della struttura RAWINPUTDEVICE . Per impostazione predefinita, un'applicazione non riceve notifiche WM_INPUT_DEVICE_CHANGE per l'arrivo e la rimozione del dispositivo di input non elaborato.
Se una struttura RAWINPUTDEVICE ha il flag RIDEV_REMOVE impostato e il parametro hwndTarget non è impostato su NULL, la convalida dei parametri avrà esito negativo.
Solo una finestra per classe di dispositivo di input non elaborato può essere registrata per ricevere input non elaborato all'interno di un processo (la finestra passata nell'ultima chiamata a RegisterRawInputDevices). A causa di questo, RegisterRawInputDevices non deve essere usato da una libreria, perché può interferire con qualsiasi logica di elaborazione di input non elaborata già presente nelle applicazioni che lo caricano.
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