IWDFUsbTargetDevice::RetrieveUsbInterface-Methode (wudfusb.h)
[Warnung: UMDF 2 ist die neueste Version von UMDF und ersetzt UMDF 1. Alle neuen UMDF-Treiber sollten mit UMDF 2 geschrieben werden. UMDF 1 werden keine neuen Features hinzugefügt, und die Unterstützung für UMDF 1 in neueren Versionen von Windows 10 ist eingeschränkt. Universelle Windows-Treiber müssen UMDF 2 verwenden. Weitere Informationen finden Sie unter Erste Schritte mit UMDF.]
Die RetrieveUsbInterface-Methode ruft die angegebene USB-Schnittstelle für ein USB-Gerät ab.
Syntax
HRESULT RetrieveUsbInterface(
[in] UCHAR InterfaceIndex,
[out] IWDFUsbInterface **ppUsbInterface
);
Parameter
[in] InterfaceIndex
Der Index der abzurufenden Schnittstelle.
[out] ppUsbInterface
Ein Zeiger auf eine Variable, die einen Zeiger auf die angegebene IWDFUsbInterface-Schnittstelle für das USB-Gerät empfängt.
Rückgabewert
RetrieveUsbInterface gibt einen der folgenden Werte zurück:
| Rückgabecode | Beschreibung |
|---|---|
|
RetrieveUsbInterface hat die angegebene USB-Schnittstelle für das USB-Gerät erfolgreich abgerufen. |
|
Bei RetrieveUsbInterface ist ein Zuordnungsfehler aufgetreten. |
|
Dieser Wert entspricht dem Fehlercode, den die WinUsb-API zurückgegeben hat. |
Hinweise
Der Treiber kann die IWDFUsbTargetDevice::GetNumInterfaces-Methode aufrufen, um die Gesamtzahl der verfügbaren USB-Schnittstellen abzurufen.
Der Treiber kann den Schnittstellenzeiger verwenden, den RetrieveUsbInterface abruft, um die Methoden aufzurufen, die die IWDFUsbInterface-Schnittstelle bereitstellt. Weitere Informationen zur Verwendung dieser Methoden finden Sie unter Arbeiten mit USB-Schnittstellen in UMDF.
Beispiele
Ein Codebeispiel für die Verwendung der RetrieveUsbInterface-Methode finden Sie unter IWDFUsbTargetFactory::CreateUsbTargetDevice.
Anforderungen
| Anforderung | Wert |
|---|---|
| Ende des Supports | In UMDF 2.0 und höher nicht verfügbar. |
| Zielplattform | Desktop |
| UMDF-Mindestversion | 1.5 |
| Kopfzeile | wudfusb.h (schließen Sie Wudfusb.h ein) |
| DLL | WUDFx.dll |