Funzione WdfUsbInterfaceGetDescriptor (wdfusb.h)

Articolo
02/07/2025

[Si applica a KMDF e UMDF]

Il metodo WdfUsbInterfaceGetDescriptor recupera il descrittore di interfaccia USB associato a un'impostazione alternativa specificata di un'interfaccia USB specificata.

Sintassi

void WdfUsbInterfaceGetDescriptor(
  [in]  WDFUSBINTERFACE           UsbInterface,
  [in]  UCHAR                     SettingIndex,
  [out] PUSB_INTERFACE_DESCRIPTOR InterfaceDescriptor
);

Parametri

[in] UsbInterface

Handle per un oggetto interfaccia USB ottenuto chiamando WdfUsbTargetDeviceGetInterface.

[in] SettingIndex

Valore di indice che identifica un'impostazione alternativa per l'interfaccia. Per altre informazioni sulle impostazioni alternative, vedi la specifica USB.

[out] InterfaceDescriptor

Puntatore a una struttura USB_INTERFACE_DESCRIPTOR allocata dal chiamante che il framework riempie.

Valore restituito

Nessuno

Osservazioni

Se il valore di SettingIndex non è valido, la struttura USB_INTERFACE_DESCRIPTOR può ricevere dati non validi.

Se il driver fornisce un handle di oggetto non valido, si verifica un controllo di bug.

Per altre informazioni sul metodo di WdfUsbInterfaceGetDescriptor e sulle destinazioni di I/O USB, vedere Destinazioni I/O USB.

Esempi

Nell'esempio di codice seguente viene ottenuto l'indice di impostazione alternativo per un'interfaccia USB specificata. L'esempio ottiene quindi il descrittore dell'interfaccia USB che rappresenta l'impostazione alternativa corrente dell'interfaccia USB.

BYTE  settingIndex;
USB_INTERFACE_DESCRIPTOR  interfaceDescriptor;

settingIndex = WdfUsbInterfaceGetConfiguredSettingIndex(
                             UsbInterface
                             );

WdfUsbInterfaceGetDescriptor(
                             UsbInterface,
                             settingIndex,
                             &interfaceDescriptor
                             );

Fabbisogno

Requisito	Valore
piattaforma di destinazione	Universale
versione minima di KMDF	1.0
versione minima di UMDF	2.0
intestazione	wdfusb.h (include Wdfusb.h)
libreria	Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF)
IRQL	<=DISPATCH_LEVEL
regole di conformità DDI	DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf), UsbKmdfIrql(kmdf), UsbKmdfIrql2(kmdf), UsbKmdfIrqlExplicit(kmdf)

Vedere anche

USB_INTERFACE_DESCRIPTOR

WdfUsbTargetDeviceGetInterface

Condividi tramite