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) |