Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
[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 RetrieveUsbPipeObject Methode ruft ein USB-Pipeobjekt für den angegebenen Pipeindex ab.
Syntax
HRESULT RetrieveUsbPipeObject(
[in] UCHAR PipeIndex,
[out] IWDFUsbTargetPipe **ppPipe
);
Parameter
[in] PipeIndex
Der Index des abzurufenden USB-Pipeobjekts.
[out] ppPipe
Ein Zeiger auf eine Variable, die einen Zeiger auf die IWDFUsbTargetPipe Schnittstelle für das USB-Pipeobjekt empfängt, dessen Index durch PipeIndex-angegeben wird.
Rückgabewert
RetrieveUsbPipeObject gibt einen der folgenden Werte zurück:
| Rückgabecode | Beschreibung |
|---|---|
|
RetrieveUsbPipeObject das USB-Pipeobjekt erfolgreich abgerufen. |
|
RetrieveUsbPipeObject ein Zuordnungsfehler aufgetreten. |
|
Dieser Wert entspricht dem Fehlercode, den die WinUsb-API zurückgegeben hat. |
Bemerkungen
Ein UMDF-Treiber kann die Methoden der IWDFUsbTargetPipe Schnittstelle aufrufen, die vom RetrieveUsbPipeObject Methode abgerufen wird, um den Typ der Pipe und andere Informationen abzurufen.
Beispiele
Ein Codebeispiel für die Verwendung derRetrieveUsbPipeObject--Methode finden Sie unter IWDFUsbInterface::GetNumEndPoints.
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 |