Funzione WdfUsbInterfaceGetDescriptor (wdfusb.h)
[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) |