IOCTL_HID_SET_POLL_FREQUENCY_MSEC IOCTL (hidclass.h)
La richiesta IOCTL_HID_SET_POLL_FREQUENCY_MSEC imposta la frequenza di polling, in millisecondi, per una raccolta di livello superiore.
Le applicazioni in modalità utente o i driver in modalità kernel che eseguono letture irregolari e opportunistiche in un dispositivo di polling devono fornire un intervallo di polling pari a zero. In questi casi, IOCTL_HID_SET_POLL_FREQUENCY_MSEC non modifica effettivamente la frequenza di polling del dispositivo; ma se i dati del report non sono obsoleti quando sono letti, la lettura viene completata immediatamente con i dati del report più recenti per la raccolta indicata. Se i dati del report non sono aggiornati, vengono aggiornati immediatamente, senza attendere la scadenza dell'intervallo di polling e la lettura viene completata con i nuovi dati.
Se il valore per l'intervallo di polling specificato in IRP non è zero, deve essere >= MIN_POLL_INTERVAL_MSEC e <= MAX_POLL_INTERVAL_MSEC.
Il polling può essere limitato se sono presenti più raccolte di livello superiore.
Per informazioni generali sui dispositivi HIDClass, vedere Raccolte HID.
Parameters.DeviceIoControl.InputBufferLength nella posizione dello stack I/O di IRP indica le dimensioni, in byte, del buffer di input, che deve essere >= sizeof(ULONG).
Irp->AssociatedIrp.SystemBuffer contiene il nuovo intervallo di polling.
Valore maggiore o uguale a sizeof(ULONG).
Nessuno.
Nessuno.
Il driver di classe HID imposta il membro Status di Irp-IoStatus> su STATUS_SUCCESS se il trasferimento è stato completato senza errori. In caso contrario, viene impostato su un codice di errore NTSTATUS appropriato.
| Requisito | Valore |
|---|---|
| Intestazione | hidclass.h (include Hidclass.h) |