Share via

IOCTL_INTERNAL_USBFN_GET_INTERFACE_DESCRIPTOR_SET IOCTL (usbfnioctl.h)

  • Artículo

El controlador de clase envía esta solicitud para obtener todo el conjunto de descriptores de interfaz USB para una función en el dispositivo.

Nota No use esta solicitud para recuperar el descriptor de interfaz establecido para todo el dispositivo.
 

Código principal

IRP_MJ_INTERNAL_DEVICE_CONTROL

Búfer de entrada

Puntero a un búfer que contiene una estructura de USBFN_INTERFACE_INFO .

Longitud del búfer de entrada

La longitud del búfer de entrada debe ser al menos sizeof(USBFN_INTERFACE_INFO).

Búfer de salida

Puntero a un búfer que contiene una estructura de USBFN_INTERFACE_INFO . La extensión de clase de función USB (UFX) rellena la estructura con todo el conjunto de descriptores de interfaz, incluidos sus descriptores de punto de conexión.

Longitud del búfer de salida

La longitud del búfer de salida debe ser al menos sizeof(USBFN_INTERFACE_INFO).

Bloque de estado

Si la solicitud se realiza correctamente, la extensión de clase de función USB (UFX) devuelve STATUS_SUCCESS u otro valor de estado para el que NT_SUCCESS(status) es igual a TRUE. De lo contrario, devuelve un valor de estado para el que NT_SUCCESS(status) es igual a FALSE.

Comentarios

Esta solicitud debe enviarse después de enviar la solicitud de IOCTL_INTERNAL_USBFN_ACTIVATE_USB_BUS .

La longitud del descriptor de interfaz completo es variable. Es posible que el controlador de clase tenga que enviar esta solicitud IOCTL dos veces para obtener todo el conjunto de descriptores.

Si la longitud del conjunto de descriptores completo es mayor que la longitud del búfer de salida especificada, UFX establece el miembro Size de USBFN_INTERFACE_INFO en la longitud real del búfer y produce un error en la solicitud con STATUS_BUFFER_TOO_SMALL. A continuación, el controlador debe asignar un búfer de salida de longitud especificado por Size y volver a enviar la solicitud.

Requisitos

Requisito Valor
Header usbfnioctl.h

Consulte también

IOCTL_INTERNAL_USBFN_ACTIVATE_USB_BUS

USBFN_INTERFACE_INFO