Funzione WdfUsbInterfaceGetDescriptor (wdfusb.h)

Articolo
02/27/2024

[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, vedere 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 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 WdfUsbInterfaceGetDescriptor e sulle destinazioni di I/O USB, vedi Destinazioni di I/O USB.

Esempio

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

BYTE  settingIndex;
USB_INTERFACE_DESCRIPTOR  interfaceDescriptor;

settingIndex = WdfUsbInterfaceGetConfiguredSettingIndex(
                             UsbInterface
                             );

WdfUsbInterfaceGetDescriptor(
                             UsbInterface,
                             settingIndex,
                             &interfaceDescriptor
                             );

Requisiti

Requisito	Valore
Piattaforma di destinazione	Universale
Versione KMDF minima	1.0
Versione UMDF minima	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)

Vedi anche

USB_INTERFACE_DESCRIPTOR

WdfUsbTargetDeviceGetInterface

Condividi tramite