funzione USBD_ValidateConfigurationDescriptor (usbdlib.h)

  • Articolo

La routine USBD_ValidateConfigurationDescriptor convalida tutti i descrittori restituiti da un dispositivo in risposta a una richiesta di descrittore di configurazione.

Sintassi

USBD_STATUS USBD_ValidateConfigurationDescriptor(
  [in]           PUSB_CONFIGURATION_DESCRIPTOR ConfigDesc,
  [in]           ULONG                         BufferLength,
  [in]           USHORT                        Level,
  [out]          PUCHAR                        *Offset,
  [in, optional] ULONG                         Tag
);

Parametri

[in] ConfigDesc

Puntatore a un descrittore di configurazione che include tutti i descrittori di interfaccia, endpoint, fornitore e descrittori specifici della classe recuperati da un dispositivo USB.

[in] BufferLength

Dimensioni, in byte, del descrittore di configurazione convalidato.

[in] Level

Livello di convalida da eseguire. I valori validi sono i seguenti:

  • Convalida di base dell'intestazione del descrittore di configurazione.
  • Convalida 2-Completa del descrittore di configurazione, incluso il controllo degli indirizzi endpoint non validi, i numeri di interfaccia, le strutture di descrittore, le impostazioni alternative dell'interfaccia, il numero di interfacce e i campi bLength di tutti i descrittori.
  • 3-Oltre alla convalida per i livelli 1 e 2, il livello 3 convalida più convalida il numero di endpoint in ogni interfaccia, applica il descrittore bLength della specifica USB e verifica che tutti i numeri di interfaccia siano in ordine sequenziale.

[out] Offset

Offset all'interno del descrittore di configurazione in cui la convalida non è riuscita. Valido solo quando viene restituito uno stato diverso da USBD_STATUS_SUCCESS.

[in, optional] Tag

Tag del pool usato da USBD_ValidateConfigurationDescriptor durante l'allocazione della memoria.

Valore restituito

USBD_STATUS_SUCCESS o codice di errore USBD appropriato se la convalida non è riuscita.

Requisiti

Requisito Valore
Client minimo supportato Disponibile in Windows Vista e nei sistemi operativi successivi.
Piattaforma di destinazione Universale
Intestazione usbdlib.h (includono Usbdlib.h)
Libreria Usbd.lib
IRQL PASSIVE_LEVEL

Vedi anche

Informazioni di riferimento sulla programmazione del driver di dispositivo USB