funzione USBD_ParseDescriptors (usbdlib.h)

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 cui eseguire la ricerca.

[in] TotalLength

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

[in] StartPosition

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

[in] DescriptorType

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

USB_STRING_DESCRIPTOR_TYPE

Specifica che il descrittore da cercare è un descrittore di stringa.

USB_INTERFACE_DESCRIPTOR_TYPE

Specifica che il descrittore da cercare è un descrittore di interfaccia.

USB_ENDPOINT_DESCRIPTOR_TYPE

Specifica che il descrittore da cercare è un descrittore dell'endpoint.

Valore restituito

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

Commenti

Questa struttura viene usata 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 ha questi campi all'inizio dei dati e dei chiamanti può usare i membri bLength e bDescriptorType per identificare correttamente il tipo di questo descrittore.

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

Requisiti

Requisito	Valore
Piattaforma di destinazione	Universale
Intestazione	usbdlib.h (includono Usbdlib.h)
Libreria	Usbd.lib
IRQL	< DISPATCH_LEVEL

Vedi anche

Informazioni di riferimento sulla programmazione del driver di dispositivo USB