Edit

WDF_USB_DEVICE_SELECT_CONFIG_PARAMS_INIT_INTERFACES_DESCRIPTORS function (wdfusb.h)

  • Article

[Applies to KMDF and UMDF]

The WDF_USB_DEVICE_SELECT_CONFIG_PARAMS_INIT_INTERFACES_DESCRIPTORS function initializes a WDF_USB_DEVICE_SELECT_CONFIG_PARAMS structure so that a driver can specify a configuration by using USB descriptors.

Syntax

void WDF_USB_DEVICE_SELECT_CONFIG_PARAMS_INIT_INTERFACES_DESCRIPTORS(
  [out] PWDF_USB_DEVICE_SELECT_CONFIG_PARAMS Params,
  [in]  PUSB_CONFIGURATION_DESCRIPTOR        ConfigDescriptor,
  [in]  PUSB_INTERFACE_DESCRIPTOR            *InterfaceDescriptors,
  [in]  ULONG                                NumInterfaceDescriptors
);

Parameters

[out] Params

A pointer to a driver-allocated WDF_USB_DEVICE_SELECT_CONFIG_PARAMS structure.

[in] ConfigDescriptor

A pointer to a USB_CONFIGURATION_DESCRIPTOR structure.

[in] InterfaceDescriptors

A pointer to an array of USB_INTERFACE_DESCRIPTOR structures.

[in] NumInterfaceDescriptors

The number of elements that is in the InterfaceDescriptors array.

Return value

None

Remarks

The WDF_USB_DEVICE_SELECT_CONFIG_PARAMS_INIT_INTERFACES_DESCRIPTORS function zeros the WDF_USB_DEVICE_SELECT_CONFIG_PARAMS structure and sets the Size member to the size of the structure. It also sets the Type member to WdfUsbTargetDeviceSelectConfigTypeInterfacesDescriptor.

This function uses the ConfigDescriptor, InterfaceDescriptors, and NumInterfaceDescriptors parameters to set the structure's Types.Descriptor union members.

To initialize a WDF_USB_DEVICE_SELECT_CONFIG_PARAMS structure, the driver must call one of the following functions:

Requirements

Requirement Value
Target Platform Universal
Minimum KMDF version 1.0
Minimum UMDF version 2.0
Header wdfusb.h (include Wdfusb.h)

See also

USB_CONFIGURATION_DESCRIPTOR

USB_INTERFACE_DESCRIPTOR

WDF_USB_DEVICE_SELECT_CONFIG_PARAMS

WDF_USB_DEVICE_SELECT_CONFIG_PARAMS_INIT_DECONFIG

WDF_USB_DEVICE_SELECT_CONFIG_PARAMS_INIT_INTERFACES_DESCRIPTORS

WDF_USB_DEVICE_SELECT_CONFIG_PARAMS_INIT_MULTIPLE_INTERFACES

WDF_USB_DEVICE_SELECT_CONFIG_PARAMS_INIT_SINGLE_INTERFACE

WDF_USB_DEVICE_SELECT_CONFIG_PARAMS_INIT_URB