funzione USBD_ParseConfigurationDescriptorEx (usbdlib.h)

Articolo
08/07/2023

La routine USBD_ParseConfigurationDescriptorEx cerca un descrittore di configurazione specificato e restituisce un puntatore a un'interfaccia che corrisponde ai criteri di ricerca specificati.

Sintassi

PUSB_INTERFACE_DESCRIPTOR USBD_ParseConfigurationDescriptorEx(
  [in] PUSB_CONFIGURATION_DESCRIPTOR ConfigurationDescriptor,
  [in] PVOID                         StartPosition,
  [in] LONG                          InterfaceNumber,
  [in] LONG                          AlternateSetting,
  [in] LONG                          InterfaceClass,
  [in] LONG                          InterfaceSubClass,
  [in] LONG                          InterfaceProtocol
);

Parametri

[in] ConfigurationDescriptor

Puntatore a un descrittore di configurazione USB che contiene l'interfaccia per cui eseguire la ricerca.

[in] StartPosition

Puntatore all'indirizzo all'interno del descrittore di configurazione, fornito in ConfigurationDescriptor, da cui iniziare la ricerca. Per eseguire una ricerca dall'inizio del descrittore di configurazione, i parametri ConfigurationDescriptor e StartPosition devono corrispondere allo stesso indirizzo.

[in] InterfaceNumber

Specifica l'indice definito dal dispositivo dell'interfaccia da recuperare. Deve essere impostato su -1 se non deve essere un criterio di ricerca.

[in] AlternateSetting

Specifica l'indice dell'impostazione alternativa definita dal dispositivo dell'interfaccia da recuperare. Se il chiamante non desidera che il valore dell'impostazione alternativa sia un criterio di ricerca, questo parametro deve essere impostato su -1.

[in] InterfaceClass

Specifica l'identificatore definito dal dispositivo o USB per la classe di interfaccia dell'interfaccia da recuperare. Se il chiamante non desidera che il valore della classe di interfaccia sia un criterio di ricerca, questo parametro deve essere impostato su -1.

[in] InterfaceSubClass

Specifica l'identificatore definito dal dispositivo o USB per la sottoclasse dell'interfaccia da recuperare. Se il chiamante non desidera che il valore della sottoclasse dell'interfaccia sia un criterio di ricerca, questo parametro deve essere impostato su -1.

[in] InterfaceProtocol

Specifica l'identificatore definito dal dispositivo o USB per il protocollo di interfaccia da recuperare. Se il chiamante non desidera che il valore del protocollo di interfaccia sia un criterio di ricerca, questo parametro deve essere impostato su -1.

Valore restituito

USBD_ParseConfigurationDescriptorEx restituisce un puntatore al primo descrittore di interfaccia che corrisponde ai criteri di ricerca specificati. Se nessuna interfaccia corrisponde ai criteri di ricerca, restituisce NULL.

Osservazioni

I chiamanti possono specificare più di uno dei criteri di ricerca (InterfaceNumber, AlternateSetting, InterfaceClass, InterfaceSubClass e InterfaceProtocol) quando si usa questa routine per trovare un'interfaccia all'interno di un descrittore di configurazione. Per un esempio di codice, vedere USBD_CreateConfigurationRequestEx.

Quando questa routine analizza il descrittore di configurazione cercando il descrittore di interfaccia che corrisponde ai criteri di ricerca, restituisce la prima corrispondenza, terminando la ricerca. I chiamanti devono specificare il numero di criteri di ricerca necessari per trovare l'interfaccia desiderata.

Fabbisogno

Requisito	Valore
piattaforma di destinazione	Universale
intestazione	usbdlib.h (include Usbdlib.h)
libreria	Usbd.lib
IRQL	< DISPATCH_LEVEL

Vedere anche

riferimento alla programmazione dei driver di dispositivo USB

USB_CONFIGURATION_DESCRIPTOR

Condividi tramite