Freigeben über


WdfUsbTargetDeviceGetInterface-Funktion (wdfusb.h)

[Gilt für KMDF und UMDF]

Die WdfUsbTargetDeviceGetInterface-Methode gibt ein Handle an das USB-Schnittstellenobjekt des Frameworks zurück, das einem angegebenen Schnittstellenindex zugeordnet ist.

Syntax

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

Parameter

[in] UsbDevice

Ein Handle für ein USB-Geräteobjekt, das aus einem vorherigen Aufruf von WdfUsbTargetDeviceCreateWithParameters abgerufen wurde.

[in] InterfaceIndex

Ein nullbasierter Indexwert, der ein USB-Schnittstellenobjekt in der aktuellen Konfiguration angibt. Dieser Indexwert ist möglicherweise nicht mit der Schnittstellennummer identisch, die von der USB-Spezifikation definiert wird.

Rückgabewert

WdfUsbTargetDeviceGetInterface gibt ein Handle an ein USB-Schnittstellenobjekt zurück. Wenn der InterfaceIndex-Wert ungültig ist, gibt diese Methode NULL zurück.

Eine Fehlerüberprüfung tritt auf, wenn ein vom Treiber bereitgestelltes Objekthandle ungültig ist.

Hinweise

Weitere Informationen zur WdfUsbTargetDeviceGetInterface-Methode und USB-E/A-Zielen finden Sie unter USB-E/A-Ziele.

Beispiele

Im folgenden Codebeispiel wird ein Handle für das erste USB-Schnittstellenobjekt abgerufen, das vom Framework für ein USB-Gerät erstellt wurde. Im Beispiel wird dann die Anzahl der Endpunkte abgerufen, die dem Schnittstellenobjekt zugeordnet sind.

WDFUSBINTERFACE  UsbInterface;
BYTE  numEndpoints;

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

Anforderungen

Anforderung Wert
Zielplattform Universell
KMDF-Mindestversion 1.0
UMDF-Mindestversion 2.0
Kopfzeile wdfusb.h (wdfusb.h einschließen)
Bibliothek Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF)
IRQL <=DISPATCH_LEVEL
DDI-Complianceregeln DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf), UsbKmdfIrql(kmdf), UsbKmdfIrql2(kmdf), UsbKmdfIrqlExplicit(kmdf)

Weitere Informationen

WdfUsbTargetDeviceCreateWithParameters