IOCTL_GET_PHYSICAL_DESCRIPTOR IOCTL (hidclass.h)

La solicitud IOCTL_GET_PHYSICAL_DESCRIPTOR obtiene el descriptor físico de un colección de nivel superior. Para un minidriver, este descriptor es el descriptor del dispositivo HIDClass.

Para obtener información general sobre los dispositivos HIDClass, consulte colecciones HID.

Código principal

IRP_MJ_DEVICE_CONTROL

Búfer de entrada

Parameters.DeviceIoControl.OutputBufferLength en la ubicación de pila de E/S del IRP indica el tamaño, en bytes, del búfer de salida.

Búfer de salida

Irp->mdlAddress debe apuntar al búfer que recibirá el descriptor físico.

El minidriver HID copia el descriptor físico en el búfer de usuario en Irp->UserBuffer.

Bloque de estado

El controlador de clase HID establece el estado miembro de Irp->IoStatus en STATUS_SUCCESS si la transferencia se completó sin error. De lo contrario, se establece en un código de error NTSTATUS adecuado.

Minidriveres HID que llevan a cabo la E/S en el dispositivo establecen los siguientes campos de Irp->IoStatus:

• de información se establece en el número de bytes transferidos desde el dispositivo.
• Estado se establece en STATUS_SUCCESS si la transferencia se completó sin error. De lo contrario, se establece en un código de error NTSTATUS adecuado.

Los minidriveres HID que llaman a otros controladores con este IRP para llevar a cabo la E/S en su dispositivo deben asegurarse de que el campo Información del bloque de estado sea correcto y no cambie el contenido del campo Estado de.

Requisitos

Requisito	Valor
encabezado de	hidclass.h (include Hidclass.h)

Consulte también

HidD_GetPhysicalDescriptor