Funzione WdfUsbTargetDeviceGetInterface (wdfusb.h)

Articolo
02/07/2025

[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 per 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 corrispondere 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.

Se un handle di oggetto fornito dal driver non è valido, viene verificato un controllo di bug.

Osservazioni

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

Esempi

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

WDFUSBINTERFACE  UsbInterface;
BYTE  numEndpoints;

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

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

WdfUsbTargetDeviceCreateWithParameters

Condividi tramite