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) |