Export (0) Print
Expand All
Expand Minimize

USBD_ValidateConfigurationDescriptor routine

The USBD_ValidateConfigurationDescriptor routine validates all descriptors returned by a device in its response to a configuration descriptor request.

Syntax


USBD_STATUS USBD_ValidateConfigurationDescriptor(
  _In_      PUSB_CONFIGURATION_DESCRIPTOR ConfigDesc,
  _In_      ULONG BufferLength,
  _In_      USHORT Level,
  _Out_     PUCHAR *Offset,
  _In_opt_  ULONG Tag
);

Parameters

ConfigDesc [in]

Pointer to a configuration descriptor that includes all interface, endpoint, vendor, and class-specific descriptors retrieved from a USB device.

BufferLength [in]

Size, in bytes, of the configuration descriptor being validated.

Level [in]

Level of validation to be performed. The following are valid values:

  • 1-Basic validation of the configuration descriptor header.
  • 2-Full validation of the configuration descriptor including checking for invalid endpoint addresses, interface numbers, descriptor structures, interface alternate settings, number of interfaces and bLength fields of all descriptors.
  • 3-In addition to the validation for levels 1 and 2, level 3 validates plus validates the number of endpoints in each interface, enforces the USB specification's descriptor bLength sizes, and verifies that all interface numbers are in sequential order.
Offset [out]

Offset within configuration descriptor where validation failed. Only valid when a status other than USBD_STATUS_SUCCESS is returned.

Tag [in, optional]

Pool tag used by USBD_ValidateConfigurationDescriptor when allocating memory.

Return value

USBD_STATUS_SUCCESS, or appropriate USBD error code if validation failed.

Requirements

Version

Available in Windows Vista and later operating systems.

Header

Usbdlib.h (include Usbdlib.h)

Library

Usbd.lib

IRQL

PASSIVE_LEVEL

See also

Routines for USB Client Drivers

 

 

Send comments about this topic to Microsoft

Show:
© 2014 Microsoft