IOCTL_HID_GET_COLLECTION_INFORMATION IOCTL (hidclass.h)

La richiesta di IOCTL_HID_GET_COLLECTION_INFORMATION ottiene la struttura di HID_COLLECTION_INFORMATIONdi una raccolta di livello superiore. Queste informazioni includono le dimensioni, in byte, dei dati pronti di una raccolta.

Per informazioni generali sui dispositivi HIDClass, vedere Raccolte HID.

Codice principale

IRP_MJ_DEVICE_CONTROL

Buffer di input

Parameters.DeviceIoControl.OutputBufferLength nella posizione dello stack I/O di IRP indica le dimensioni, in byte, del buffer di output, che deve essere >= sizeof(HID_COLLECTION_INFORMATION).

Lunghezza del buffer di input

Maggiore o uguale a sizeof(HID_COLLECTION_INFORMATION).

Buffer di output

Irp->AssociatedIrp.SystemBuffer punta a un buffer che riceverà le informazioni sulla raccolta. Questi dati verranno formattati nel buffer fornito dal richiedente come struttura HID_COLLECTION_INFORMATION.

Lunghezza del buffer di output

Dimensione di una struttura HID_COLLECTION_INFORMATION.

Blocco dello stato

Il driver di classe HID imposta i campi seguenti di Irp-IoStatus>:

• Le informazioni vengono impostate su sizeof(HID_COLLECTION_INFORMATION) se i dati sono stati recuperati correttamente.
• Lo stato è impostato su STATUS_SUCCESS se il trasferimento è stato completato senza errori. In caso contrario, viene impostato su un codice di errore NTSTATUS appropriato.

Requisiti

Requisito	Valore
Intestazione	hidclass.h (include Hidclass.h)

Vedi anche

HID_COLLECTION_INFORMATION