IWDFUsbTargetDevice::RetrieveDeviceInformation-Methode (wudfusb.h)

Artikel
02/07/2025

[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 RetrieveDeviceInformation Methode ruft Geräteinformationen des angegebenen Typs ab.

Syntax

HRESULT RetrieveDeviceInformation(
  [in]      ULONG InformationType,
  [in, out] ULONG *BufferLength,
  [out]     PVOID Buffer
);

Parameter

[in] InformationType

Der Typ der Informationen, die der UMDF-Treiber über das Gerät anfordert.

[in, out] BufferLength

Ein Zeiger auf eine Variable, die bei eingabe die Größe des Puffers in Byte enthält, der RetrieveDeviceInformation in Buffer-bereitstellt. Bei der Ausgabe enthält dieser Parameter die Größe, die RetrieveDeviceInformation für Bufferbenötigt.

[out] Buffer

Ein Zeiger, der den Puffer empfängt, der die Geräteinformationen enthält.

Rückgabewert

RetrieveDeviceInformation gibt einen der folgenden Werte zurück:

Rückgabecode	Beschreibung
S_OK	RetrieveDeviceInformation die Geräteinformationen erfolgreich abgerufen.
E_OUTOFMEMORY	RetrieveDeviceInformation ein Zuordnungsfehler aufgetreten.
Ein Fehlercode, der in winerror.h definiert ist	Dieser Wert entspricht dem Fehlercode, den die WinUsb-API zurückgegeben hat.

Bemerkungen

Informationen zu gültigen Informationstypen, die ein UMDF-Treiber für den InformationType Parameter übergeben kann, finden Sie in der funktion WinUsb_QueryDeviceInformation.

Wenn InformationType- DEVICE_SPEED (0x01) ist, gibt Buffer- die Betriebsgeschwindigkeit des Geräts an. 0x03 gibt hochgeschwindigkeits oder höher an; 0x01 gibt die Volle Geschwindigkeit oder niedriger an.

Die RetrieveDeviceInformation Methode generiert eine UMDF-Anforderung und sendet die Anforderung synchron an das E/A-Ziel.

Beispiele

Ein Codebeispiel für die Verwendung derRetrieveDeviceInformation--Methode finden Sie unter IWDFUsbTargetPipe::SetPipePolicy.

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

Siehe auch

IWDFUsbTargetDevice

WinUsb_QueryDeviceInformation

Freigeben über