funzione USBD_ParseDescriptors (usbdlib.h)

Articolo
02/07/2025

La routine USBD_ParseDescriptors cerca un descrittore di configurazione specificato e restituisce un puntatore al primo descrittore che corrisponde ai criteri di ricerca.

Sintassi

PUSB_COMMON_DESCRIPTOR USBD_ParseDescriptors(
  [in] PVOID DescriptorBuffer,
  [in] ULONG TotalLength,
  [in] PVOID StartPosition,
  [in] LONG  DescriptorType
);

Parametri

[in] DescriptorBuffer

Puntatore a un descrittore di configurazione che contiene il descrittore per il quale eseguire la ricerca.

[in] TotalLength

Specifica le dimensioni, in byte, del buffer a cui punta DescrittoreBuffer.

[in] StartPosition

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

[in] DescriptorType

Specifica il codice del tipo di descrittore assegnato da USB. I valori seguenti sono validi per i tipi di descrittore definiti da USB:

USB_STRING_DESCRIPTOR_TYPE

Specifica che il descrittore cercato è un descrittore di stringa.

USB_INTERFACE_DESCRIPTOR_TYPE

Specifica che il descrittore cercato è un descrittore di interfaccia.

USB_ENDPOINT_DESCRIPTOR_TYPE

Specifica che il descrittore cercato è un descrittore di endpoint.

Valore restituito

USBD_ParseDescriptors restituisce un puntatore a una struttura USB_COMMON_DESCRIPTOR che corrisponde al primo descrittore corrispondente ai criteri di ricerca specificati oppure viene restituito NULL se non viene trovata alcuna corrispondenza:

Osservazioni

Questa struttura viene utilizzata per contenere una parte di un descrittore, in modo che il chiamante di USBD_ParseDescriptors possa determinare la struttura corretta da usare per accedere ai dati rimanenti nel descrittore. Ogni tipo di descrittore include questi campi all'inizio dei dati e i chiamanti possono usare il bLength e bDescriptorType membri per identificare correttamente il tipo di questo descrittore.

Quando questa routine analizza il descrittore di configurazione alla ricerca del descrittore che corrisponde ai criteri di ricerca, restituisce la prima corrispondenza, terminando la ricerca.

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

Condividi tramite