Compartir a través de

estructura _URB_OS_FEATURE_DESCRIPTOR_REQUEST (usb.h)

  • Artículo

El controlador del concentrador USB usa la estructura _URB_OS_FEATURE_DESCRIPTOR_REQUEST para recuperar descriptores de características del sistema operativo de Microsoft desde un dispositivo USB o una interfaz en un dispositivo USB.

Sintaxis

struct _URB_OS_FEATURE_DESCRIPTOR_REQUEST {
  struct _URB_HEADER   Hdr;
  PVOID                Reserved;
  ULONG                Reserved0;
  ULONG                TransferBufferLength;
  PVOID                TransferBuffer;
  PMDL                 TransferBufferMDL;
  struct _URB          *UrbLink;
  struct _URB_HCD_AREA hca;
  UCHAR                Recipient : 5;
  UCHAR                Reserved1 : 3;
  UCHAR                Reserved2;
  UCHAR                InterfaceNumber;
  UCHAR                MS_PageIndex;
  USHORT               MS_FeatureDescriptorIndex;
  USHORT               Reserved3;
};

Miembros

Hdr

Puntero a una estructura de _URB_HEADER que especifica la información del encabezado URB. Hdr.Function debe URB_FUNCTION_GET_MS_FEATURE_DESCRIPTOR. Hdr.Length debe ser sizeof(_URB_OS_FEATURE_DESCRIPTOR_REQUEST).

Reserved

Reserved0

TransferBufferLength

Especifica la longitud, en bytes, del búfer especificado en TransferBuffer o descrito en TransferBufferMDL. El controlador del controlador de host devuelve el número de bytes leídos en este miembro. La implementación actual de esta función limita el tamaño máximo del descriptor de características de MS OS a 4 kilobytes.

TransferBuffer

Puntero a un búfer residente para la transferencia o es NULL si se proporciona una MDL en TransferBufferMDL.

TransferBufferMDL

Puntero a una MDL que describe un búfer residente o es NULL si se proporciona un búfer en TransferBuffer. Este MDL debe asignarse desde un grupo no paginado.

UrbLink

Reservado. No utilizar.

hca

Recipient

Especifica si el destinatario es el dispositivo USB o una interfaz en el dispositivo USB. Se debe especificar uno de los valores siguientes:

  • 0 indica que el dispositivo USB es el destinatario de la solicitud.
  • 1 indica que una interfaz USB es el destinatario de la solicitud.
  • 2 indica que un punto de conexión USB es el destinatario de la solicitud.

Reserved1

Reserved2

InterfaceNumber

Indica el número de interfaz que es el destinatario de la solicitud, si el valor del miembro Recipient es 1. Debe establecerse en 0 si el dispositivo USB es el destinatario.

MS_PageIndex

Se debe establecer en 0. Índice de página de la página 64K del descriptor de características de MS OS que se va a devolver. La implementación actual solo admite un tamaño de descriptor máximo de 4K.

MS_FeatureDescriptorIndex

Índice del descriptor de características de MS OS que se va a solicitar.

Reserved3

Comentarios

Los miembros reservados de esta estructura deben tratarse como opacos y están reservados para uso del sistema.

Requisitos

Requisito Value
Cliente mínimo compatible Disponible en Windows XP y sistemas operativos posteriores.
Encabezado usb.h (incluya Usb.h)

Consulte también

URB

_URB_HEADER