WDF_USB_DEVICE_SELECT_CONFIG_PARAMS struttura (wdfusb.h)
[Si applica a KMDF e UMDF]
La struttura WDF_USB_DEVICE_SELECT_CONFIG_PARAMS specifica i parametri di configurazione del dispositivo USB.
Sintassi
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;
Members
Size
Dimensione, in byte, della struttura.
Type
Valore tipizzato WdfUsbTargetDeviceSelectConfigType che specifica il tipo di configurazione selezionato o indica che la configurazione corrente viene deconfigurata.
Types
Types.Descriptor
Types.Descriptor.ConfigurationDescriptor
Se il driver imposta il membro Type su WdfUsbTargetDeviceSelectConfigTypeInterfacesDescriptor, questo membro contiene un puntatore fornito dal driver a una struttura USB_CONFIGURATION_DESCRIPTOR che specifica un descrittore di configurazione. Se questo puntatore è NULL, il framework usa la prima configurazione del dispositivo. Per altre informazioni sulla selezione di una configurazione USB, vedere la sezione Osservazioni di WdfUsbTargetDeviceSelectConfig.
Types.Descriptor.InterfaceDescriptors
Se il driver imposta Type su WdfUsbTargetDeviceSelectConfigTypeInterfacesDescriptor, questo membro contiene un puntatore fornito dal driver a una matrice di strutture USB_INTERFACE_DESCRIPTOR che rappresentano le interfacce da selezionare per la configurazione.
Types.Descriptor.NumInterfaceDescriptors
Se il driver imposta Type su WdfUsbTargetDeviceSelectConfigTypeInterfacesDescriptor, questo membro contiene il numero di elementi che si trovano nella matrice di interfaccia a cui Type.Descriptor.InterfaceDescriptors punta.
Types.Urb
Types.Urb.Urb
Se il driver imposta Type su WdfUsbTargetDeviceSelectConfigTypeUrb, questo membro specifica una struttura DI DIRECTORY inizializzata dal driver utilizzata dal framework per configurare il dispositivo.
Types.SingleInterface
Types.SingleInterface.NumberConfiguredPipes
Se il driver imposta Tipo su WdfUsbTargetDeviceSelectConfigTypeSingleInterface, il framework fornisce il numero di pipe configurate per l'interfaccia.
Types.SingleInterface.ConfiguredUsbInterface
Se il driver imposta Type su WdfUsbTargetDeviceSelectConfigTypeSingleInterface, il framework fornisce un handle a un oggetto interfaccia USB che rappresenta l'interfaccia configurata.
Types.MultiInterface
Types.MultiInterface.NumberInterfaces
Se il driver imposta Type su WdfUsbTargetDeviceSelectConfigTypeInterfacesPairs, questo membro specifica il numero di elementi presenti nella matrice Types.MultiInterface.Pair .
Types.MultiInterface.Pairs
Se il driver imposta Type su WdfUsbTargetDeviceSelectConfigTypeInterfacesPairs, questo membro specifica un puntatore a una matrice di strutture WDF_USB_INTERFACE_SETTING_PAIR che identificano le interfacce da selezionare.
Types.MultiInterface.NumberOfConfiguredInterfaces
Se il driver imposta Type su WdfUsbTargetDeviceSelectConfigTypeInterfacesPairs o WdfUsbTargetDeviceSelectConfigTypeMultiInterface, il framework fornisce il numero di interfacce configurate per il dispositivo.
Commenti
La struttura WDF_USB_DEVICE_SELECT_CONFIG_PARAMS viene usata come input per WdfUsbTargetDeviceSelectConfig.
Per inizializzare una struttura WDF_USB_DEVICE_SELECT_CONFIG_PARAMS , usare una delle funzioni seguenti:
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 il driver imposta il membro Type su WdfUsbTargetDeviceSelectConfigTypeInterfacesDescriptor, può modificare la configurazione del dispositivo USB. Tutti gli altri valori usano la configurazione corrente del dispositivo USB.
Requisiti
Requisito | Valore |
---|---|
Versione KMDF minima | 1.0 |
Versione UMDF minima | 2,0 |
Intestazione | wdfusb.h (include Wdfusb.h) |