función USBD_ValidateConfigurationDescriptor (usbdlib.h)

Artículo
02/26/2024

La rutina USBD_ValidateConfigurationDescriptor valida todos los descriptores devueltos por un dispositivo en su respuesta a una solicitud de descriptor de configuración.

Sintaxis

USBD_STATUS USBD_ValidateConfigurationDescriptor(
  [in]           PUSB_CONFIGURATION_DESCRIPTOR ConfigDesc,
  [in]           ULONG                         BufferLength,
  [in]           USHORT                        Level,
  [out]          PUCHAR                        *Offset,
  [in, optional] ULONG                         Tag
);

Parámetros

[in] ConfigDesc

Puntero a un descriptor de configuración que incluye todas las interfaces, puntos de conexión, proveedor y descriptores específicos de clase recuperados de un dispositivo USB.

[in] BufferLength

Tamaño, en bytes, del descriptor de configuración que se está validando.

[in] Level

Nivel de validación que se va a realizar. Los valores válidos son los siguientes:

1-Validación básica del encabezado del descriptor de configuración.
2-Validación completa del descriptor de configuración, incluida la comprobación de direcciones de punto de conexión no válidas, números de interfaz, estructuras de descriptor, configuración alternativa de interfaz, número de interfaces y campos bLength de todos los descriptores.
3-Además de la validación de los niveles 1 y 2, el nivel 3 valida más valida el número de puntos de conexión en cada interfaz, aplica los tamaños bLength descriptor de la especificación USB y comprueba que todos los números de interfaz están en orden secuencial.

[out] Offset

Desplazamiento dentro del descriptor de configuración en el que se produjo un error en la validación. Solo es válido cuando se devuelve un estado distinto de USBD_STATUS_SUCCESS.

[in, optional] Tag

Etiqueta de grupo usada por USBD_ValidateConfigurationDescriptor al asignar memoria.

Valor devuelto

USBD_STATUS_SUCCESS, o el código de error de USBD adecuado si se produjo un error en la validación.

Requisitos

Requisito	Value
Cliente mínimo compatible	Disponible en Windows Vista y sistemas operativos posteriores.
Plataforma de destino	Universal
Encabezado	usbdlib.h (incluya Usbdlib.h)
Library	Usbd.lib
IRQL	PASSIVE_LEVEL

Consulte también

Referencia de programación del controlador de dispositivo USB

Share via