WdfUsbTargetDeviceGetInterface-Funktion (wdfusb.h)

[Gilt für KMDF und UMDF]

Die WdfUsbTargetDeviceGetInterface--Methode gibt ein Handle an das USB-Framework-Schnittstellenobjekt 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 WdfUsbTargetDeviceCreateWithParametersabgerufen wurde.

[in] InterfaceIndex

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

Rückgabewert

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

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

Bemerkungen

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

Beispiele

Das folgende Codebeispiel ruft ein Handle für das erste USB-Schnittstellenobjekt ab, das das Framework für ein USB-Gerät erstellt hat. Das Beispiel ruft dann die Anzahl der Endpunkte ab, die dem Schnittstellenobjekt zugeordnet sind.

WDFUSBINTERFACE  UsbInterface;
BYTE  numEndpoints;

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

Anforderungen

Siehe auch

WdfUsbTargetDeviceCreateWithParameters