Compartir a través de

función USBD_ValidateConfigurationDescriptor (usbdlib.h)

  • Artículo

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 todos los descriptores de interfaz, punto de conexión, proveedor y específicos de clase recuperados de un dispositivo USB.

[in] BufferLength

Tamaño, en bytes, del descriptor de configuración que se va a validar.

[in] Level

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

  • 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 descriptores, configuración alternativa de interfaz, número de interfaces y bLength campos 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 el descriptor de la especificación USB tamaños de bLength 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 de validación.

Requisitos

Requisito Valor
cliente mínimo admitido Disponible en Windows Vista y sistemas operativos posteriores.
de la plataforma de destino de Universal
encabezado de usbdlib.h (include Usbdlib.h)
biblioteca de Usbd.lib
irQL PASSIVE_LEVEL

Consulte también

referencia de programación del controlador de dispositivo USB