Funzione WdfUsbTargetDeviceGetInterface (wdfusb.h)

Articolo
02/27/2024

[Si applica a KMDF e UMDF]

Il metodo WdfUsbTargetDeviceGetInterface restituisce un handle all'oggetto interfaccia USB del framework associato a un indice di interfaccia specificato.

Sintassi

WDFUSBINTERFACE WdfUsbTargetDeviceGetInterface(
  [in] WDFUSBDEVICE UsbDevice,
  [in] UCHAR        InterfaceIndex
);

Parametri

[in] UsbDevice

Handle a un oggetto dispositivo USB ottenuto da una chiamata precedente a WdfUsbTargetDeviceCreateWithParameters.

[in] InterfaceIndex

Valore di indice in base zero che specifica un oggetto interfaccia USB nella configurazione corrente. Questo valore di indice potrebbe non essere uguale al numero di interfaccia definito dalla specifica USB.

Valore restituito

WdfUsbTargetDeviceGetInterface restituisce un handle a un oggetto interfaccia USB. Se il valore InterfaceIndex non è valido, questo metodo restituisce NULL.

Un controllo di bug si verifica se un handle di oggetti fornito dal driver non è valido.

Commenti

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

Esempio

Nell'esempio di codice seguente viene ottenuto un handle per il primo oggetto interfaccia USB creato dal framework per un dispositivo USB. L'esempio ottiene quindi il numero di endpoint associati all'oggetto interface.

WDFUSBINTERFACE  UsbInterface;
BYTE  numEndpoints;

UsbInterface = WdfUsbTargetDeviceGetInterface(
                                              deviceContext->UsbTargetDevice,
                                              0
                                              );
numEndpoints = WdfUsbInterfaceGetNumEndpoints(
                                              UsbInterface,
                                              0
                                              );

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

WdfUsbTargetDeviceCreateWithParameters