estrutura WDF_USB_DEVICE_SELECT_CONFIG_PARAMS (wdfusb.h)

[Aplica-se a KMDF e UMDF]

A estrutura WDF_USB_DEVICE_SELECT_CONFIG_PARAMS especifica parâmetros de configuração de dispositivo USB.

Sintaxe

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;

Membros

Size

O tamanho, em bytes, dessa estrutura.

Type

Um valor do tipo WdfUsbTargetDeviceSelectConfigType que especifica o tipo de configuração que está sendo selecionado ou indica que a configuração atual está sendo desconfigurada.

Types

Types.Descriptor

Types.Descriptor.ConfigurationDescriptor

Se o driver definir o membro Type como WdfUsbTargetDeviceSelectConfigTypeInterfacesDescriptor, esse membro conterá um ponteiro fornecido pelo driver para uma estrutura USB_CONFIGURATION_DESCRIPTOR que especifica um descritor de configuração. Se esse ponteiro for NULL, a estrutura usará a primeira configuração do dispositivo. Para obter mais informações sobre como selecionar uma configuração USB, consulte a seção Comentários de WdfUsbTargetDeviceSelectConfig.

Types.Descriptor.InterfaceDescriptors

Se o driver definir Type como WdfUsbTargetDeviceSelectConfigTypeInterfacesDescriptor, esse membro conterá um ponteiro fornecido pelo driver para uma matriz de estruturas USB_INTERFACE_DESCRIPTOR que representam as interfaces a serem selecionadas para a configuração.

Types.Descriptor.NumInterfaceDescriptors

Se o driver definir Type como WdfUsbTargetDeviceSelectConfigTypeInterfacesDescriptor, esse membro conterá o número de elementos que estão na matriz de interface para a qual Types.Descriptor.InterfaceDescriptors aponta.

Types.Urb

Types.Urb.Urb

Se o driver definir Type como WdfUsbTargetDeviceSelectConfigTypeUrb, esse membro especificará uma estrutura URB inicializada pelo driver que a estrutura usa para configurar o dispositivo.

Types.SingleInterface

Types.SingleInterface.NumberConfiguredPipes

Se o driver definir Type como WdfUsbTargetDeviceSelectConfigTypeSingleInterface, a estrutura fornecerá o número de pipes configurados para a interface.

Types.SingleInterface.ConfiguredUsbInterface

Se o driver definir Type como WdfUsbTargetDeviceSelectConfigTypeSingleInterface, a estrutura fornecerá um identificador para um objeto de interface USB que representa a interface configurada.

Types.MultiInterface

Types.MultiInterface.NumberInterfaces

Se o driver definir Type como WdfUsbTargetDeviceSelectConfigTypeInterfacesPairs, esse membro especificará o número de elementos que estão na matriz Types.MultiInterface.Pairs .

Types.MultiInterface.Pairs

Se o driver definir Type como WdfUsbTargetDeviceSelectConfigTypeInterfacesPairs, esse membro especificará um ponteiro para uma matriz de estruturas WDF_USB_INTERFACE_SETTING_PAIR que identificam as interfaces a serem selecionadas.

Types.MultiInterface.NumberOfConfiguredInterfaces

Se o driver definir Type como WdfUsbTargetDeviceSelectConfigTypeInterfacesPairs ou WdfUsbTargetDeviceSelectConfigTypeMultiInterface, a estrutura fornecerá o número de interfaces configuradas para o dispositivo.

Comentários

A estrutura WDF_USB_DEVICE_SELECT_CONFIG_PARAMS é usada como entrada para WdfUsbTargetDeviceSelectConfig.

Para inicializar uma estrutura WDF_USB_DEVICE_SELECT_CONFIG_PARAMS , use uma das seguintes funções:

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

Se o driver definir o membro Type como WdfUsbTargetDeviceSelectConfigTypeInterfacesDescriptor, ele poderá alterar a configuração do dispositivo USB. Todos os outros valores usam a configuração atual do dispositivo USB.

Requisitos

Requisito	Valor
Versão mínima do KMDF	1.0
Versão mínima do UMDF	2,0
Cabeçalho	wdfusb.h (include Wdfusb.h)

Confira também

USB_CONFIGURATION_DESCRIPTOR

USB_INTERFACE_DESCRIPTOR

WDF_USB_INTERFACE_SETTING_PAIR

WdfUsbTargetDeviceSelectConfigType