estructura WDF_USB_DEVICE_SELECT_CONFIG_PARAMS (wdfusb.h)

[Se aplica a KMDF y UMDF]

La estructura WDF_USB_DEVICE_SELECT_CONFIG_PARAMS especifica los parámetros de configuración del dispositivo USB.

Sintaxis

typedef struct _WDF_USB_DEVICE_SELECT_CONFIG_PARAMS {
  ULONG                              Size;
  WdfUsbTargetDeviceSelectConfigType Type;
  union {
    struct {
      PUSB_CONFIGURATION_DESCRIPTOR ConfigurationDescriptor;
      PUSB_INTERFACE_DESCRIPTOR     *InterfaceDescriptors;
      ULONG                         NumInterfaceDescriptors;
    } Descriptor;
    struct {
      PURB Urb;
    } Urb;
    struct {
      UCHAR           NumberConfiguredPipes;
      WDFUSBINTERFACE ConfiguredUsbInterface;
    } SingleInterface;
    struct {
      UCHAR                           NumberInterfaces;
      PWDF_USB_INTERFACE_SETTING_PAIR Pairs;
      UCHAR                           NumberOfConfiguredInterfaces;
    } MultiInterface;
  } Types;
} WDF_USB_DEVICE_SELECT_CONFIG_PARAMS, *PWDF_USB_DEVICE_SELECT_CONFIG_PARAMS;

Miembros

Size

Tamaño, en bytes, de esta estructura.

Type

Valor WdfUsbTargetDeviceSelectConfigType con tipo que especifica el tipo de configuración que se está seleccionado o indica que la configuración actual se está desconfigurando.

Types

Types.Descriptor

Types.Descriptor.ConfigurationDescriptor

Si el controlador establece el miembro Type en WdfUsbTargetDeviceSelectConfigTypeInterfacesDescriptor, este miembro contiene un puntero proporcionado por el controlador a una estructura de USB_CONFIGURATION_DESCRIPTOR que especifica un descriptor de configuración. Si este puntero es NULL, el marco usa la primera configuración del dispositivo. Para obtener más información sobre cómo seleccionar una configuración USB, vea la sección Comentarios de WdfUsbTargetDeviceSelectConfig.

Types.Descriptor.InterfaceDescriptors

Si el controlador establece Type en WdfUsbTargetDeviceSelectConfigTypeInterfacesDescriptor, este miembro contiene un puntero proporcionado por el controlador a una matriz de estructuras de USB_INTERFACE_DESCRIPTOR que representan las interfaces que se van a seleccionar para la configuración.

Types.Descriptor.NumInterfaceDescriptors

Si el controlador establece Type en WdfUsbTargetDeviceSelectConfigTypeInterfacesDescriptor, este miembro contiene el número de elementos que se encuentran en la matriz de interfaz a la que apunta Types.Descriptor.InterfaceDescriptors .

Types.Urb

Types.Urb.Urb

Si el controlador establece Type en WdfUsbTargetDeviceSelectConfigTypeUrb, este miembro especifica una estructura URB inicializada por el controlador que usa el marco para configurar el dispositivo.

Types.SingleInterface

Types.SingleInterface.NumberConfiguredPipes

Si el controlador establece Type en WdfUsbTargetDeviceSelectConfigTypeSingleInterface, el marco proporciona el número de canalizaciones configuradas para la interfaz.

Types.SingleInterface.ConfiguredUsbInterface

Si el controlador establece Type en WdfUsbTargetDeviceSelectConfigTypeSingleInterface, el marco proporciona un identificador a un objeto de interfaz USB que representa la interfaz configurada.

Types.MultiInterface

Types.MultiInterface.NumberInterfaces

Si el controlador establece Type en WdfUsbTargetDeviceSelectConfigTypeInterfacesPairs, este miembro especifica el número de elementos que se encuentran en la matriz Types.MultiInterface.Pairs .

Types.MultiInterface.Pairs

Si el controlador establece Type en WdfUsbTargetDeviceSelectConfigTypeInterfacesPairs, este miembro especifica un puntero a una matriz de estructuras de WDF_USB_INTERFACE_SETTING_PAIR que identifican las interfaces que se van a seleccionar.

Types.MultiInterface.NumberOfConfiguredInterfaces

Si el controlador establece Type en WdfUsbTargetDeviceSelectConfigTypeInterfacesPairs o WdfUsbTargetDeviceSelectConfigTypeMultiInterface, el marco proporciona el número de interfaces configuradas para el dispositivo.

Comentarios

La estructura WDF_USB_DEVICE_SELECT_CONFIG_PARAMS se usa como entrada para WdfUsbTargetDeviceSelectConfig.

Para inicializar una estructura de WDF_USB_DEVICE_SELECT_CONFIG_PARAMS , use una de las siguientes funciones:

WDF_USB_DEVICE_SELECT_CONFIG_PARAMS_INIT_DECONFIG

WDF_USB_DEVICE_SELECT_CONFIG_PARAMS_INIT_SINGLE_INTERFACE

WDF_USB_DEVICE_SELECT_CONFIG_PARAMS_INIT_MULTIPLE_INTERFACES

WDF_USB_DEVICE_SELECT_CONFIG_PARAMS_INIT_INTERFACES_DESCRIPTORS

WDF_USB_DEVICE_SELECT_CONFIG_PARAMS_INIT_URB

Si el controlador establece el miembro Type en WdfUsbTargetDeviceSelectConfigTypeInterfacesDescriptor, puede cambiar la configuración del dispositivo USB. Todos los demás valores usan la configuración actual del dispositivo USB.

Requisitos

Requisito	Value
Versión mínima de KMDF	1.0
Versión mínima de UMDF	2.0
Encabezado	wdfusb.h (incluya Wdfusb.h)

Consulte también

USB_CONFIGURATION_DESCRIPTOR

USB_INTERFACE_DESCRIPTOR

WDF_USB_INTERFACE_SETTING_PAIR

WdfUsbTargetDeviceSelectConfigType