IOCTL_GET_PHYSICAL_DESCRIPTOR IOCTL (hidclass.h)

La solicitud IOCTL_GET_PHYSICAL_DESCRIPTOR obtiene el descriptor físico de una 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 miembro Status de Irp-IoStatus> en STATUS_SUCCESS si la transferencia se completó sin errores. De lo contrario, se establece en un código de error NTSTATUS adecuado.

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

• La información se establece en el número de bytes transferidos desde el dispositivo.
• El 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 minicontroladores 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 es correcto y no cambiar el contenido del campo Estado .

Requisitos

Requisito	Valor
Header	hidclass.h (include Hidclass.h)

Consulte también

HidD_GetPhysicalDescriptor