función USBD_ParseDescriptors (usbdlib.h)

La rutina USBD_ParseDescriptors busca 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 comenzar la búsqueda. Para buscar desde el principio del descriptor de configuración, los parámetros DescriptorBuffer e StartPosition deben ser la misma dirección.

[in] DescriptorType

Especifica el código de tipo descriptor asignado por USB. Los valores siguientes 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 está buscando 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 de 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:

Comentarios

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 usará para tener acceso a los datos restantes del descriptor. Cada tipo de descriptor tiene estos campos al principio de los datos y los llamadores pueden usar los miembros bLength y bDescriptorType 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	Value
Plataforma de destino	Universal
Encabezado	usbdlib.h (incluye Usbdlib.h)
Library	Usbd.lib
IRQL	< DISPATCH_LEVEL

Consulte también

Referencia de programación del controlador de dispositivo USB