función USBD_ParseDescriptors (usbdlib.h)

La rutina USBD_ParseDescriptors busca en un descriptor de configuración determinado y devuelve un puntero al primer descriptor que coincide con los criterios de búsqueda.

Sintaxis

PUSB_COMMON_DESCRIPTOR USBD_ParseDescriptors(
  [in] PVOID DescriptorBuffer,
  [in] ULONG TotalLength,
  [in] PVOID StartPosition,
  [in] LONG  DescriptorType
);

Parámetros

[in] DescriptorBuffer

Puntero a un descriptor de configuración que contiene el descriptor para el que se va a buscar.

[in] TotalLength

Especifica el tamaño, en bytes, del búfer al que apunta DescriptorBuffer.

[in] StartPosition

Puntero a la dirección dentro del descriptor de configuración, proporcionado en DescriptorBuffer, para empezar a buscar. Para buscar desde el principio del descriptor de configuración, los parámetros DescriptorBuffer y StartPosition deben ser la misma dirección.

[in] DescriptorType

Especifica el código de tipo de descriptor asignado por USB. Los siguientes valores son válidos para los tipos de descriptores definidos por USB:

USB_STRING_DESCRIPTOR_TYPE

Especifica que el descriptor que se busca es un descriptor de cadena.

USB_INTERFACE_DESCRIPTOR_TYPE

Especifica que el descriptor que se busca es un descriptor de interfaz.

USB_ENDPOINT_DESCRIPTOR_TYPE

Especifica que el descriptor que se está buscando es un descriptor de punto de conexión.

Valor devuelto

USBD_ParseDescriptors devuelve un puntero a una estructura USB_COMMON_DESCRIPTOR que es el encabezado del primer descriptor que coincide con los criterios de búsqueda especificados o se devuelve NULL si no se encuentra ninguna coincidencia:

Observaciones

Esta estructura se usa para contener una parte de un descriptor, de modo que el autor de la llamada de USBD_ParseDescriptors pueda determinar la estructura correcta que se va a usar para acceder a los datos restantes del descriptor. Cada tipo de descriptor tiene estos campos al principio de los datos y las llamadas pueden usar el bLength y bDescriptorType miembros para identificar correctamente el tipo de este descriptor.

Cuando esta rutina analiza el descriptor de configuración que busca el descriptor que coincide con los criterios de búsqueda, devuelve la primera coincidencia, finalizando la búsqueda.

Requisitos

Requisito	Valor
de la plataforma de destino de	Universal
encabezado de	usbdlib.h (include Usbdlib.h)
biblioteca de	Usbd.lib
irQL	< DISPATCH_LEVEL

Consulte también

referencia de programación del controlador de dispositivo USB