IOCTL_GET_PHYSICAL_DESCRIPTOR IOCTL (hidclass.h)

La richiesta di IOCTL_GET_PHYSICAL_DESCRIPTOR ottiene il descrittore fisico di una raccolta di livello superiore. Per un minidriver, questo descrittore è il descrittore del dispositivo HIDClass.

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 dell'IRP indica le dimensioni, in byte, del buffer di output.

Buffer di output

Irp->MdlAddress deve puntare al buffer che riceverà il descrittore fisico.

Il minidriver HID copia il descrittore fisico nel buffer utente in Irp-UserBuffer>.

Blocco dello stato

Il driver di classe HID imposta il membro Status di Irp-IoStatus> su STATUS_SUCCESS se il trasferimento è stato completato senza errore. In caso contrario, è impostato su un codice di errore NTSTATUS appropriato.

I minidriver HID che eseguono l'I/O al dispositivo impostano i campi seguenti di Irp-IoStatus>:

• Le informazioni vengono impostate sul numero di byte trasferiti dal dispositivo.
• Lo stato è impostato su STATUS_SUCCESS se il trasferimento è stato completato senza errore. In caso contrario, è impostato su un codice di errore NTSTATUS appropriato.

I minidriver HID che chiamano altri driver con questa IRP per eseguire l'I/O nel dispositivo devono assicurarsi che il campo Informazioni del blocco di stato sia corretto e non modificare il contenuto del campo Stato .

Requisiti

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

Vedi anche

HidD_GetPhysicalDescriptor