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)

Vedi anche

USB_CONFIGURATION_DESCRIPTOR

USB_INTERFACE_DESCRIPTOR

WDF_USB_INTERFACE_SETTING_PAIR

WdfUsbTargetDeviceSelectConfigType