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. Es werden keine neuen Features zu UMDF 1 hinzugefügt, und es gibt eingeschränkte Unterstützung für UMDF 1 für neuere Versionen von Windows 10. 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 einen der folgenden Werte zurück:
| Rückgabecode | Beschreibung |
|---|---|
|
RetrieveUsbInterface die angegebene USB-Schnittstelle für das USB-Gerät erfolgreich abgerufen. |
|
RetrieveUsbInterface ein Zuordnungsfehler aufgetreten. |
|
Dieser Wert entspricht dem Fehlercode, den die WinUsb-API zurückgegeben hat. |
Bemerkungen
Der Treiber kann die IWDFUsbTargetDevice::GetNumInterfaces Methode aufrufen, um die Gesamtanzahl der verfügbaren USB-Schnittstellen abzurufen.
Der Treiber kann den Schnittstellenzeiger verwenden, der abgerufen RetrieveUsbInterface, 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 |
| Mindest-UMDF-Version | 1.5 |
| Header- | wudfusb.h (include Wudfusb.h) |
| DLL- | WUDFx.dll |