Funzione RegisterRawInputDevices (winuser.h)

  • Articolo

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

RAWINPUTDEVICE

Input non elaborato

Riferimento

WM_INPUT